GdPicture.NET.14.API~GdPicture14.GdPicturePDF~SaveToStream - SaveToStream(Stream,PdfEncryption,String,String,Boolean,Boolean,Boolean,Boolean,Boolean,Boolean,Boolean,Boolean) Method

Visual Basic
C#
Delphi
JScript
Managed Extensions for C++
C++/CLI

'Declaration

 

Public Overloads Function SaveToStream( _

   ByVal Stream As Stream, _

   ByVal EncryptionScheme As PdfEncryption, _

   ByVal UserPass As String, _

   ByVal OwnerPass As String, _

   ByVal CanPrint As Boolean, _

   ByVal CanCopy As Boolean, _

   ByVal CanModify As Boolean, _

   ByVal CanAddNotes As Boolean, _

   ByVal CanFillFields As Boolean, _

   ByVal CanCopyAccess As Boolean, _

   ByVal CanAssemble As Boolean, _

   ByVal CanPrintFull As Boolean _

) As GdPictureStatus

public GdPictureStatus SaveToStream( 

   Stream Stream,

   PdfEncryption EncryptionScheme,

   string UserPass,

   string OwnerPass,

   bool CanPrint,

   bool CanCopy,

   bool CanModify,

   bool CanAddNotes,

   bool CanFillFields,

   bool CanCopyAccess,

   bool CanAssemble,

   bool CanPrintFull

)

public function SaveToStream( 

    Stream: Stream;

    EncryptionScheme: PdfEncryption;

    UserPass: String;

    OwnerPass: String;

    CanPrint: Boolean;

    CanCopy: Boolean;

    CanModify: Boolean;

    CanAddNotes: Boolean;

    CanFillFields: Boolean;

    CanCopyAccess: Boolean;

    CanAssemble: Boolean;

    CanPrintFull: Boolean

): GdPictureStatus;

public function SaveToStream( 

   Stream : Stream,

   EncryptionScheme : PdfEncryption,

   UserPass : String,

   OwnerPass : String,

   CanPrint : boolean,

   CanCopy : boolean,

   CanModify : boolean,

   CanAddNotes : boolean,

   CanFillFields : boolean,

   CanCopyAccess : boolean,

   CanAssemble : boolean,

   CanPrintFull : boolean

) : GdPictureStatus;

public: GdPictureStatus SaveToStream( 

   Stream* Stream,

   PdfEncryption EncryptionScheme,

   string* UserPass,

   string* OwnerPass,

   bool CanPrint,

   bool CanCopy,

   bool CanModify,

   bool CanAddNotes,

   bool CanFillFields,

   bool CanCopyAccess,

   bool CanAssemble,

   bool CanPrintFull

)

public:

GdPictureStatus SaveToStream( 

   Stream^ Stream,

   PdfEncryption EncryptionScheme,

   String^ UserPass,

   String^ OwnerPass,

   bool CanPrint,

   bool CanCopy,

   bool CanModify,

   bool CanAddNotes,

   bool CanFillFields,

   bool CanCopyAccess,

   bool CanAssemble,

   bool CanPrintFull

)

Parameters

Stream: A Stream object where the currently loaded PDF document will be saved to. This Stream object must be initialized before it can be sent into this method and it should remain open for subsequent use.
EncryptionScheme: A member of the PdfEncryption enumeration. The encryption algorithm you have to specify. This algorithm will be used to encrypt your PDF document according to other specified parameters.
UserPass: The user (open) password as a string. You can set null value here or an empty string as well. The null value will alway be converted to an empty string. Please read more about passwords in the Remarks section.
OwnerPass: The owner (permission, master) password as a string. You can set null value here or an empty string as well. The null value will always be converted to an empty string. Please read more about passwords in the Remarks section.
CanPrint: Allows the user to print the document, but possibly not at the highest quality level, see also PdfRightCanPrintFull. It is ignored if the EncryptionScheme parameter is set to PdfEncryption.PdfEncryptionNone.
CanCopy: Allows the user to copy or extract text and graphics from the document. It is ignored if the EncryptionScheme parameter is set to PdfEncryption.PdfEncryptionNone.
CanModify: Allows the user to modify the document. It is ignored if the EncryptionScheme parameter is set to PdfEncryption.PdfEncryptionNone.
CanAddNotes: Allows the user to add annotations. It is ignored if the EncryptionScheme parameter is set to PdfEncryption.PdfEncryptionNone.
CanFillFields: Allows the user to fill-in form fields. It works only with 128-bit encryption.
CanCopyAccess: Enables copying or extracting for use with accessibility features. It works only with 128-bit encryption.
CanAssemble: Allows the user to assemble the document. It works only with 128-bit encryption.
CanPrintFull: Allows high resolution printing of the document. It works only with 128-bit encryption.

Return Value

A member of the GdPictureStatus enumeration. If the method has been successfully followed, then the return value is GdPictureStatus.OK.

We strongly recommend always checking this status first.

This method requires the PDF Processing component to run.

Some basic rules for better understanding the use of the user and the owner passwords are described in details within the GdPicturePDF.SaveToFilemethod.

This method requires the PDF Processing component to run.

How to encrypt and save the PDF document to a stream.

VB.NET
C#

Dim caption As String = "Example: SaveToStream"

Dim gdpicturePDF As New GdPicturePDF()

Dim status As GdPictureStatus = GdPictureStatus.OK

If gdpicturePDF.LoadFromFile("testPDF.pdf", False) = GdPictureStatus.OK Then

    Dim oFileStream As New System.IO.FileStream("encryptedStream.pdf", System.IO.FileMode.Create)

    'Encrypting and saving the document to a stream.

    status = gdpicturePDF.SaveToStream(oFileStream, PdfEncryption.PdfEncryption256BitAES, "user", "owner", False, False, False, False, False, False, False, False)

    If status = GdPictureStatus.OK Then

        MessageBox.Show("The encrypted file has been saved successfully.", caption)

        'Closing the current file.

        gdpicturePDF.CloseDocument()

        oFileStream.Dispose()

        oFileStream = New System.IO.FileStream("encryptedStream.pdf", System.IO.FileMode.Open)

        'Loading the encrypted document.

        status = gdpicturePDF.LoadFromStream(oFileStream)

        If status = GdPictureStatus.OK Then

            Dim encrypted As Boolean = gdpicturePDF.IsEncrypted()

            status = gdpicturePDF.GetStat()

            MessageBox.Show("The encrypted file has been loaded successfully." + vbCrLf + "The IsEncrypted method returns: " + encrypted.ToString() + "    status: " + status.ToString(), caption)

        Else

            MessageBox.Show("The encrypted file has failed to load.", caption)

        End If

        oFileStream.Dispose()

    Else

        MessageBox.Show("The encrypted file has failed to save.", caption)

    End If

Else

    MessageBox.Show("The file can't be loaded.", caption)

End If

gdpicturePDF.Dispose()

string caption = "Example: SaveToStream";

GdPicturePDF gdpicturePDF = new GdPicturePDF();

GdPictureStatus status = GdPictureStatus.OK;

if (gdpicturePDF.LoadFromFile("testPDF.pdf", false) == GdPictureStatus.OK)

{

    System.IO.FileStream oFileStream = new System.IO.FileStream("encryptedStream.pdf", System.IO.FileMode.Create);

    //Encrypting and saving the document to a stream.

    status = gdpicturePDF.SaveToStream(oFileStream, PdfEncryption.PdfEncryption256BitAES, "user", "owner", false, false, false, false, false, false, false, false);

    if (status == GdPictureStatus.OK)

    {

        MessageBox.Show("The encrypted file has been saved successfully.", caption);

        //Closing the current file.

        gdpicturePDF.CloseDocument();

        oFileStream.Dispose();

        oFileStream = new System.IO.FileStream("encryptedStream.pdf", System.IO.FileMode.Open);

        //Loading the encrypted document.

        status = gdpicturePDF.LoadFromStream(oFileStream);

        if (status == GdPictureStatus.OK)

        {

            bool encrypted = gdpicturePDF.IsEncrypted();

            status = gdpicturePDF.GetStat();

            MessageBox.Show("The encrypted file has been loaded successfully.\nThe IsEncrypted method returns: " + encrypted.ToString() + "    status: " + status.ToString(), caption);

        }

        else

        {

            MessageBox.Show("The encrypted file has failed to load.", caption);

        }

        oFileStream.Dispose();

    }

    else

    {

        MessageBox.Show("The encrypted file has failed to save.", caption);

    }

}

else

{

    MessageBox.Show("The file can't be loaded.", caption);

}

gdpicturePDF.Dispose();

How to encrypt and save the PDF document to a stream. Dim caption As String = "Example: SaveToStream" Dim gdpicturePDF As New GdPicturePDF() Dim status As GdPictureStatus = GdPictureStatus.OK If gdpicturePDF.LoadFromFile("testPDF.pdf", False) = GdPictureStatus.OK Then Dim oFileStream As New System.IO.FileStream("encryptedStream.pdf", System.IO.FileMode.Create) 'Encrypting and saving the document to a stream. status = gdpicturePDF.SaveToStream(oFileStream, PdfEncryption.PdfEncryption256BitAES, "user", "owner", False, False, False, False, False, False, False, False) If status = GdPictureStatus.OK Then MessageBox.Show("The encrypted file has been saved successfully.", caption) 'Closing the current file. gdpicturePDF.CloseDocument() oFileStream.Dispose() oFileStream = New System.IO.FileStream("encryptedStream.pdf", System.IO.FileMode.Open) 'Loading the encrypted document. status = gdpicturePDF.LoadFromStream(oFileStream) If status = GdPictureStatus.OK Then Dim encrypted As Boolean = gdpicturePDF.IsEncrypted() status = gdpicturePDF.GetStat() MessageBox.Show("The encrypted file has been loaded successfully." + vbCrLf + "The IsEncrypted method returns: " + encrypted.ToString() + " status: " + status.ToString(), caption) Else MessageBox.Show("The encrypted file has failed to load.", caption) End If oFileStream.Dispose() Else MessageBox.Show("The encrypted file has failed to save.", caption) End If Else MessageBox.Show("The file can't be loaded.", caption) End If gdpicturePDF.Dispose() string caption = "Example: SaveToStream"; GdPicturePDF gdpicturePDF = new GdPicturePDF(); GdPictureStatus status = GdPictureStatus.OK; if (gdpicturePDF.LoadFromFile("testPDF.pdf", false) == GdPictureStatus.OK) { System.IO.FileStream oFileStream = new System.IO.FileStream("encryptedStream.pdf", System.IO.FileMode.Create); //Encrypting and saving the document to a stream. status = gdpicturePDF.SaveToStream(oFileStream, PdfEncryption.PdfEncryption256BitAES, "user", "owner", false, false, false, false, false, false, false, false); if (status == GdPictureStatus.OK) { MessageBox.Show("The encrypted file has been saved successfully.", caption); //Closing the current file. gdpicturePDF.CloseDocument(); oFileStream.Dispose(); oFileStream = new System.IO.FileStream("encryptedStream.pdf", System.IO.FileMode.Open); //Loading the encrypted document. status = gdpicturePDF.LoadFromStream(oFileStream); if (status == GdPictureStatus.OK) { bool encrypted = gdpicturePDF.IsEncrypted(); status = gdpicturePDF.GetStat(); MessageBox.Show("The encrypted file has been loaded successfully.\nThe IsEncrypted method returns: " + encrypted.ToString() + " status: " + status.ToString(), caption); } else { MessageBox.Show("The encrypted file has failed to load.", caption); } oFileStream.Dispose(); } else { MessageBox.Show("The encrypted file has failed to save.", caption); } } else { MessageBox.Show("The file can't be loaded.", caption); } gdpicturePDF.Dispose();

Reference

GdPicturePDF Class
GdPicturePDF Members
Overload List
SetPassword Method
SaveToFile(String,PdfEncryption,String,String,Boolean,Boolean,Boolean,Boolean,Boolean,Boolean,Boolean,Boolean) Method
SaveToFile(String) Method
LoadFromFile Method
LoadFromStream Method
EnableCompression Method
RemoveUnusedResources Method
Dispose Method
IsEncrypted Method
SetPassword Method