Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

CryptoStream Class

Defines a stream that links data streams to cryptographic transformations.

For a list of all members of this type, see CryptoStream Members.

System.Object
   System.MarshalByRefObject
      System.IO.Stream
         System.Security.Cryptography.CryptoStream

[Visual Basic]
Public Class CryptoStream
   Inherits Stream
[C#]
public class CryptoStream : Stream
[C++]
public __gc class CryptoStream : public Stream
[JScript]
public class CryptoStream extends Stream

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Remarks

The common language runtime uses a stream-oriented design for cryptography. The core of this design is CryptoStream. Any cryptographic objects that implement CryptoStream can be chained together with any objects that implement Stream, so the streamed output from one object can be fed into the input of another object. The intermediate result (the output from the first object) does not need to be stored separately.

Example

[Visual Basic, C#, C++] The following example demonstrates how to use a CryptoStream to encrypt a byte array. This method uses RijndaelManaged with the specified Key and initialization vector (IV) to encrypt a file specified by inName, and outputs the encrypted result to the file specified by outName. The rijnKey and rijnIV parameters to the method are 16-byte arrays. You must have the high encryption pack installed to run this sample.

[Visual Basic] 
Private Shared Sub EncryptData(inName As String, outName As String, _
rijnKey() As Byte, rijnIV() As Byte)

    'Create the file streams to handle the input and output files.
    Dim fin As New FileStream(inName, FileMode.Open, FileAccess.Read)
    Dim fout As New FileStream(outName, FileMode.OpenOrCreate, _
       FileAccess.Write)
    fout.SetLength(0)
    
    'Create variables to help with read and write.
    Dim bin(100) As Byte 'This is intermediate storage for the encryption.
    Dim rdlen As Long = 0 'This is the total number of bytes written.
    Dim totlen As Long = fin.Length 'Total length of the input file.
    Dim len As Integer 'This is the number of bytes to be written at a time.
    'Creates the default implementation, which is RijndaelManaged.
    Dim rijn As SymmetricAlgorithm = SymmetricAlgorithm.Create()
    Dim encStream As New CryptoStream(fout, _
       rijn.CreateEncryptor(rijnKey, rijnIV), CryptoStreamMode.Write)
    
    Console.WriteLine("Encrypting...")
    
    'Read from the input file, then encrypt and write to the output file.
    While rdlen < totlen
        len = fin.Read(bin, 0, 100)
        encStream.Write(bin, 0, len)
        rdlen = Convert.ToInt32(rdlen + len)
        Console.WriteLine("{0} bytes processed", rdlen)
    End While
    
    encStream.Close()
fout.Close()
fin.Close()
End Sub

[C#] 
private static void EncryptData(String inName, String outName, byte[] rijnKey, byte[] rijnIV)
 {    
     //Create the file streams to handle the input and output files.
     FileStream fin = new FileStream(inName, FileMode.Open, FileAccess.Read);
     FileStream fout = new FileStream(outName, FileMode.OpenOrCreate, FileAccess.Write);
     fout.SetLength(0);
       
     //Create variables to help with read and write.
     byte[] bin = new byte[100]; //This is intermediate storage for the encryption.
     long rdlen = 0;              //This is the total number of bytes written.
     long totlen = fin.Length;    //This is the total length of the input file.
     int len;                     //This is the number of bytes to be written at a time.
 
     SymmetricAlgorithm rijn = SymmetricAlgorithm.Create(); //Creates the default implementation, which is RijndaelManaged.         
     CryptoStream encStream = new CryptoStream(fout, rijn.CreateEncryptor(rijnKey, rijnIV), CryptoStreamMode.Write);
                
     Console.WriteLine("Encrypting...");
 
     //Read from the input file, then encrypt and write to the output file.
     while(rdlen < totlen)
     {
         len = fin.Read(bin, 0, 100);
         encStream.Write(bin, 0, len);
         rdlen = rdlen + len;
         Console.WriteLine("{0} bytes processed", rdlen);
     }
 
     encStream.Close();  
     fout.Close();
     fin.Close();                   
 }

[C++] 
void EncryptData(String* inName, String* outName, Byte rijnKey[], Byte rijnIV[])
{    
    //Create the file streams to handle the input and output files.
    FileStream* fin = new FileStream(inName, FileMode::Open, FileAccess::Read);
    FileStream* fout = new FileStream(outName, FileMode::OpenOrCreate, FileAccess::Write);
    fout->SetLength(0);

    //Create variables to help with read and write.
    Byte bin[] = new Byte[100]; //This is intermediate storage for the encryption.
    long rdlen = 0;              //This is the total number of bytes written.
    long totlen = (long)fin->Length;//This is the total length of the input file.
    int len;                     //This is the number of bytes to be written at a time.

    SymmetricAlgorithm* rijn = SymmetricAlgorithm::Create(); //Creates the default implementation, which is RijndaelManaged.         
    CryptoStream* encStream = new CryptoStream(fout, rijn->CreateEncryptor(rijnKey, rijnIV), CryptoStreamMode::Write);

    Console::WriteLine(S"Encrypting...");

    //Read from the input file, then encrypt and write to the output file.
    while(rdlen < totlen)
    {
        len = fin->Read(bin, 0, 100);
        encStream->Write(bin, 0, len);
        rdlen = rdlen + len;
        Console::WriteLine(S"{0} bytes processed", __box(rdlen));
    }

    encStream->Close();  
    fout->Close();
    fin->Close();                   
}

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Namespace: System.Security.Cryptography

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

Assembly: Mscorlib (in Mscorlib.dll)

See Also

CryptoStream Members | System.Security.Cryptography Namespace | Cryptographic Services

Show:
© 2014 Microsoft