﻿<?xml version="1.0" encoding="utf-8"?><Type Name="SymmetricAlgorithm" FullName="System.Security.Cryptography.SymmetricAlgorithm"><TypeSignature Maintainer="auto" Language="C#" Value="public abstract class SymmetricAlgorithm : IDisposable" /><TypeSignature Language="ILAsm" Value=".class public auto ansi abstract beforefieldinit SymmetricAlgorithm extends System.Object implements class System.IDisposable" /><AssemblyInfo><AssemblyName>mscorlib</AssemblyName><AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00]</AssemblyPublicKey><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement><Base><BaseTypeName>System.Object</BaseTypeName></Base><Interfaces><Interface><InterfaceName>System.IDisposable</InterfaceName></Interface></Interfaces><Attributes><Attribute><AttributeName>System.Runtime.InteropServices.ComVisible(true)</AttributeName></Attribute></Attributes><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>The classes that derive from the <see cref="T:System.Security.Cryptography.SymmetricAlgorithm" /> class use a chaining mode called cipher block chaining (CBC), which requires a key (<see cref="P:System.Security.Cryptography.SymmetricAlgorithm.Key" />) and an initialization vector (<see cref="P:System.Security.Cryptography.SymmetricAlgorithm.IV" />) to perform cryptographic transformations on data.  To decrypt data that was encrypted using one of the <see cref="T:System.Security.Cryptography.SymmetricAlgorithm" /> classes, you must set the <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.Key" /> property and the <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.IV" /> property to the same values that were used for encryption.  For a symmetric algorithm to be useful, the secret key must be known only to the sender and the receiver.</para><para><see cref="T:System.Security.Cryptography.RijndaelManaged" />, <see cref="T:System.Security.Cryptography.DESCryptoServiceProvider" />, <see cref="T:System.Security.Cryptography.RC2CryptoServiceProvider" />, and <see cref="T:System.Security.Cryptography.TripleDESCryptoServiceProvider" /> are implementations of symmetric algorithms.</para><para>Note that when using derived classes, it is not enough, from a security perspective, to simply force a garbage collection after you have finished using the object. You must explicitly call the <see cref="M:System.Security.Cryptography.SymmetricAlgorithm.Clear" /> method on the object to zero out any sensitive data within the object before it is released. Note that garbage collection does not zero out the contents of collected objects but simply marks the memory as available for reallocation. Thus the data contained within a garbage collected object may still be present in the memory heap in unallocated memory. In the case of cryptographic objects, this data could contain sensitive information such as key data or a block of plain text. </para><para>All cryptographic classes in the .NET Framework that hold sensitive data implement a Clear method. When called, the Clear method overwrites all sensitive data within the object with zeros and then releases the object so that it can be safely garbage collected. When the object has been zeroed and released, you should then call the Dispose method with the <paramref name="disposing" /> parameter set to True to dispose of all managed and unmanaged resources associated with the object.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Represents the abstract base class from which all implementations of symmetric algorithms must inherit.</para></summary></Docs><Members><Member MemberName=".ctor"><MemberSignature Language="C#" Value="protected SymmetricAlgorithm ();" /><MemberSignature Language="ILAsm" Value=".method familyhidebysig specialname rtspecialname instance void .ctor() cil managed" /><MemberType>Constructor</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue /><Parameters /><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>You cannot create an instance of an abstract class. Application code creates a new instance of a derived class.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Initializes a new instance of the <see cref="T:System.Security.Cryptography.SymmetricAlgorithm" /> class.</para></summary></Docs></Member><Member MemberName="BlockSize"><MemberSignature Language="C#" Value="public virtual int BlockSize { get; set; }" /><MemberSignature Language="ILAsm" Value=".property instance int32 BlockSize" /><MemberType>Property</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Int32</ReturnType></ReturnValue><Docs><value>To be added.</value><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>The block size is the basic unit of data that can be encrypted or decrypted in one operation. Messages longer than the block size are handled as successive blocks; messages shorter than the block size must be padded with extra bits to reach the size of a block. Valid block sizes are determined by the symmetric algorithm used.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Gets or sets the block size, in bits, of the cryptographic operation.</para></summary></Docs></Member><Member MemberName="BlockSizeValue"><MemberSignature Language="C#" Value="protected int BlockSizeValue;" /><MemberSignature Language="ILAsm" Value=".field family int32 BlockSizeValue" /><MemberType>Field</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Int32</ReturnType></ReturnValue><Parameters /><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>The block size is the basic unit of data that can be encrypted or decrypted in one operation. Messages longer than the block size are handled as successive blocks; messages shorter than the block size must be padded with extra bits to reach the size of a block. Valid block sizes are determined by the symmetric algorithm used.</para><para>This field is accessed through the <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.BlockSize" /> property.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Represents the block size, in bits, of the cryptographic operation.</para></summary></Docs></Member><Member MemberName="Clear"><MemberSignature Language="C#" Value="public void Clear ();" /><MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Clear() cil managed" /><MemberType>Method</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Void</ReturnType></ReturnValue><Parameters /><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>Note that when using derived classes, it is not enough, from a security perspective, to simply force a garbage collection after you have finished using the object. You must explicitly call the <see cref="M:System.Security.Cryptography.SymmetricAlgorithm.Clear" /> method on the object to zero out any sensitive data within the object before it is released. Note that garbage collection does not zero out the contents of collected objects but simply marks the memory as available for reallocation. Thus the data contained within a garbage collected object may still be present in the memory heap in unallocated memory. In the case of cryptographic objects, this data could contain sensitive information such as key data or a block of plain text. </para><para>All cryptographic classes in the .NET Framework that hold sensitive data implement a Clear method. When called, the Clear method overwrites all sensitive data within the object with zeros and then releases the object so that it can be safely garbage collected. When the object has been zeroed and released, you should then call the Dispose method with the <paramref name="disposing" /> parameter set to True to dispose of all managed and unmanaged resources associated with the object.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Releases all resources used by the <see cref="T:System.Security.Cryptography.SymmetricAlgorithm" /> class.</para></summary></Docs></Member><Member MemberName="Create"><MemberSignature Language="C#" Value="public static System.Security.Cryptography.SymmetricAlgorithm Create ();" /><MemberSignature Language="ILAsm" Value=".method public static hidebysig class System.Security.Cryptography.SymmetricAlgorithm Create() cil managed" /><MemberType>Method</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Security.Cryptography.SymmetricAlgorithm</ReturnType></ReturnValue><Parameters /><Docs><remarks>To be added</remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Creates a default cryptographic object used to perform the symmetric algorithm.</para></summary><returns><attribution license="cc4" from="Microsoft" modified="false" /><para>A default cryptographic object used to perform the symmetric algorithm.</para></returns></Docs></Member><Member MemberName="Create"><MemberSignature Language="C#" Value="public static System.Security.Cryptography.SymmetricAlgorithm Create (string algName);" /><MemberSignature Language="ILAsm" Value=".method public static hidebysig class System.Security.Cryptography.SymmetricAlgorithm Create(string algName) cil managed" /><MemberType>Method</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Security.Cryptography.SymmetricAlgorithm</ReturnType></ReturnValue><Parameters><Parameter Name="algName" Type="System.String" /></Parameters><Docs><remarks>To be added</remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Creates the specified cryptographic object used to perform the symmetric algorithm.</para></summary><returns><attribution license="cc4" from="Microsoft" modified="false" /><para>A cryptographic object used to perform the symmetric algorithm.</para></returns><param name="algName"><attribution license="cc4" from="Microsoft" modified="false" />The name of the specific implementation of the <see cref="T:System.Security.Cryptography.SymmetricAlgorithm" /> class to use. </param></Docs></Member><Member MemberName="CreateDecryptor"><MemberSignature Language="C#" Value="public virtual System.Security.Cryptography.ICryptoTransform CreateDecryptor ();" /><MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance class System.Security.Cryptography.ICryptoTransform CreateDecryptor() cil managed" /><MemberType>Method</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Security.Cryptography.ICryptoTransform</ReturnType></ReturnValue><Parameters /><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>This method decrypts an encrypted message created using the <see cref="M:System.Security.Cryptography.SymmetricAlgorithm.CreateEncryptor" /> overload with the same signature.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Creates a symmetric decryptor object with the current <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.Key" /> property and initialization vector (<see cref="P:System.Security.Cryptography.SymmetricAlgorithm.IV" />).</para></summary><returns><attribution license="cc4" from="Microsoft" modified="false" /><para>A symmetric decryptor object.</para></returns></Docs></Member><Member MemberName="CreateDecryptor"><MemberSignature Language="C#" Value="public abstract System.Security.Cryptography.ICryptoTransform CreateDecryptor (byte[] rgbKey, byte[] rgbIV);" /><MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance class System.Security.Cryptography.ICryptoTransform CreateDecryptor(unsigned int8[] rgbKey, unsigned int8[] rgbIV) cil managed" /><MemberType>Method</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Security.Cryptography.ICryptoTransform</ReturnType></ReturnValue><Parameters><Parameter Name="rgbKey" Type="System.Byte[]" /><Parameter Name="rgbIV" Type="System.Byte[]" /></Parameters><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>This method decrypts an encrypted message created using the <see cref="M:System.Security.Cryptography.SymmetricAlgorithm.CreateEncryptor" /> overload with the same parameters.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>When overridden in a derived class, creates a symmetric decryptor object with the specified <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.Key" /> property and initialization vector (<see cref="P:System.Security.Cryptography.SymmetricAlgorithm.IV" />).</para></summary><returns><attribution license="cc4" from="Microsoft" modified="false" /><para>A symmetric decryptor object.</para></returns><param name="rgbKey"><attribution license="cc4" from="Microsoft" modified="false" />The secret key to use for the symmetric algorithm. </param><param name="rgbIV"><attribution license="cc4" from="Microsoft" modified="false" />The initialization vector to use for the symmetric algorithm. </param></Docs></Member><Member MemberName="CreateEncryptor"><MemberSignature Language="C#" Value="public virtual System.Security.Cryptography.ICryptoTransform CreateEncryptor ();" /><MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance class System.Security.Cryptography.ICryptoTransform CreateEncryptor() cil managed" /><MemberType>Method</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Security.Cryptography.ICryptoTransform</ReturnType></ReturnValue><Parameters /><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>If the current <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.Key" /> property is null, the <see cref="M:System.Security.Cryptography.SymmetricAlgorithm.GenerateKey" /> method is called to create a new random <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.Key" />. If the current <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.IV" /> property is null, the <see cref="M:System.Security.Cryptography.SymmetricAlgorithm.GenerateIV" /> method is called to create a new random <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.IV" />.</para><para>Use the <see cref="M:System.Security.Cryptography.SymmetricAlgorithm.CreateDecryptor" /> overload with the same signature to decrypt the result of this method.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Creates a symmetric encryptor object with the current <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.Key" /> property and initialization vector (<see cref="P:System.Security.Cryptography.SymmetricAlgorithm.IV" />).</para></summary><returns><attribution license="cc4" from="Microsoft" modified="false" /><para>A symmetric encryptor object.</para></returns></Docs></Member><Member MemberName="CreateEncryptor"><MemberSignature Language="C#" Value="public abstract System.Security.Cryptography.ICryptoTransform CreateEncryptor (byte[] rgbKey, byte[] rgbIV);" /><MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance class System.Security.Cryptography.ICryptoTransform CreateEncryptor(unsigned int8[] rgbKey, unsigned int8[] rgbIV) cil managed" /><MemberType>Method</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Security.Cryptography.ICryptoTransform</ReturnType></ReturnValue><Parameters><Parameter Name="rgbKey" Type="System.Byte[]" /><Parameter Name="rgbIV" Type="System.Byte[]" /></Parameters><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>Use the <see cref="M:System.Security.Cryptography.SymmetricAlgorithm.CreateDecryptor" /> overload with the same parameters to decrypt the result of this method.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>When overridden in a derived class, creates a symmetric encryptor object with the specified <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.Key" /> property and initialization vector (<see cref="P:System.Security.Cryptography.SymmetricAlgorithm.IV" />).</para></summary><returns><attribution license="cc4" from="Microsoft" modified="false" /><para>A symmetric encryptor object.</para></returns><param name="rgbKey"><attribution license="cc4" from="Microsoft" modified="false" />The secret key to use for the symmetric algorithm. </param><param name="rgbIV"><attribution license="cc4" from="Microsoft" modified="false" />The initialization vector to use for the symmetric algorithm. </param></Docs></Member><Member MemberName="Dispose"><MemberSignature Language="C#" Value="public void Dispose ();" /><MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void Dispose() cil managed" /><MemberType>Method</MemberType><AssemblyInfo><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Void</ReturnType></ReturnValue><Parameters /><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>Call Dispose when you are finished using the <see cref="T:System.Security.Cryptography.SymmetricAlgorithm" />. The Dispose method leaves the <see cref="T:System.Security.Cryptography.SymmetricAlgorithm" /> in an unusable state. After calling Dispose, you must release all references to the <see cref="T:System.Security.Cryptography.SymmetricAlgorithm" /> so the garbage collector can reclaim the memory that the <see cref="T:System.Security.Cryptography.SymmetricAlgorithm" /> was occupying.</para><para>For more information, see <format type="text/html"><a href="A17B0066-71C2-4BA4-9822-8E19332FC213">Cleaning Up Unmanaged Resources</a></format> and <format type="text/html"><a href="eb4e1af0-3b48-4fbc-ad4e-fc2f64138bf9">Implementing a Dispose Method</a></format>.</para><block subset="none" type="note"><para>Always call Dispose before you release your last reference to the <see cref="T:System.Security.Cryptography.SymmetricAlgorithm" />. Otherwise, the resources it is using will not be freed until the garbage collector calls the <see cref="T:System.Security.Cryptography.SymmetricAlgorithm" /> object's Finalize method.</para></block></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Releases all resources used by the current instance of the <see cref="T:System.Security.Cryptography.SymmetricAlgorithm" /> class.</para></summary></Docs></Member><Member MemberName="Dispose"><MemberSignature Language="C#" Value="protected virtual void Dispose (bool disposing);" /><MemberSignature Language="ILAsm" Value=".method familyhidebysig newslot virtual instance void Dispose(bool disposing) cil managed" /><MemberType>Method</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Void</ReturnType></ReturnValue><Parameters><Parameter Name="disposing" Type="System.Boolean" /></Parameters><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>This method is called by the public Dispose() method and the Finalize method. Dispose() invokes the protected Dispose(Boolean) method with the <paramref name="disposing" /> parameter set to true. Finalize invokes Dispose with <paramref name="disposing" /> set to false.</para><para>When the <paramref name="disposing" /> parameter is true, this method releases all resources held by any managed objects that this <see cref="T:System.Security.Cryptography.SymmetricAlgorithm" /> references. This method invokes the Dispose() method of each referenced object.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Releases the unmanaged resources used by the <see cref="T:System.Security.Cryptography.SymmetricAlgorithm" /> and optionally releases the managed resources.</para></summary><param name="disposing"><attribution license="cc4" from="Microsoft" modified="false" />true to release both managed and unmanaged resources; false to release only unmanaged resources. </param></Docs></Member><Member MemberName="FeedbackSize"><MemberSignature Language="C#" Value="public virtual int FeedbackSize { get; set; }" /><MemberSignature Language="ILAsm" Value=".property instance int32 FeedbackSize" /><MemberType>Property</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Int32</ReturnType></ReturnValue><Docs><value>To be added.</value><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>The feedback size determines the amount of data that is fed back to successive encryption or decryption operations. The feedback size cannot be greater than the block size.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Gets or sets the feedback size, in bits, of the cryptographic operation.</para></summary></Docs></Member><Member MemberName="FeedbackSizeValue"><MemberSignature Language="C#" Value="protected int FeedbackSizeValue;" /><MemberSignature Language="ILAsm" Value=".field family int32 FeedbackSizeValue" /><MemberType>Field</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Int32</ReturnType></ReturnValue><Parameters /><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>The feedback size determines the amount of data that is fed back to successive encryption or decryption operations. The feedback size cannot be greater than the block size.</para><para>This field is accessed through the <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.FeedbackSize" /> property.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Represents the feedback size, in bits, of the cryptographic operation.</para></summary></Docs></Member><Member MemberName="Finalize"><MemberSignature Language="C#" Value="~SymmetricAlgorithm ();" /><MemberType>Method</MemberType><ReturnValue><ReturnType>System.Void</ReturnType></ReturnValue><Parameters /><Docs><summary>To be added.</summary><remarks>To be added.</remarks></Docs><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion></AssemblyInfo></Member><Member MemberName="GenerateIV"><MemberSignature Language="C#" Value="public abstract void GenerateIV ();" /><MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void GenerateIV() cil managed" /><MemberType>Method</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Void</ReturnType></ReturnValue><Parameters /><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>In general, there is no reason to use this method, because CreateEncryptor() or CreateEncryptor(null, null) automatically generates both an initialization vector and a key. However, you may want to use the <see cref="M:System.Security.Cryptography.SymmetricAlgorithm.GenerateIV" /> method to reuse a symmetric algorithm instance with a different initialization vector.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>When overridden in a derived class, generates a random initialization vector (<see cref="P:System.Security.Cryptography.SymmetricAlgorithm.IV" />) to use for the algorithm.</para></summary></Docs></Member><Member MemberName="GenerateKey"><MemberSignature Language="C#" Value="public abstract void GenerateKey ();" /><MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void GenerateKey() cil managed" /><MemberType>Method</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Void</ReturnType></ReturnValue><Parameters /><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>In general, there is no reason to use this method, because CreateEncryptor() or CreateEncryptor(null, null) automatically generates both an initialization vector and a key. However, you may want to use the <see cref="M:System.Security.Cryptography.SymmetricAlgorithm.GenerateKey" /> method to reuse a symmetric algorithm instance with a different key.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>When overridden in a derived class, generates a random key (<see cref="P:System.Security.Cryptography.SymmetricAlgorithm.Key" />) to use for the algorithm. </para></summary></Docs></Member><Member MemberName="IV"><MemberSignature Language="C#" Value="public virtual byte[] IV { get; set; }" /><MemberSignature Language="ILAsm" Value=".property instance unsigned int8[] IV" /><MemberType>Property</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Byte[]</ReturnType></ReturnValue><Docs><value>To be added.</value><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>The <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.IV" /> property is automatically set to a new random value whenever you create a new instance of one of the <see cref="T:System.Security.Cryptography.SymmetricAlgorithm" /> classes or when you manually call the <see cref="M:System.Security.Cryptography.SymmetricAlgorithm.GenerateIV" /> method.  The size of the <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.IV" /> property must be the same as the <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.BlockSize" /> property divided by 8. </para><para>The classes that derive from the <see cref="T:System.Security.Cryptography.SymmetricAlgorithm" /> class use a chaining mode called cipher block chaining (CBC), which requires a key and an initialization vector to perform cryptographic transformations on data.  To decrypt data that was encrypted using one of the <see cref="T:System.Security.Cryptography.SymmetricAlgorithm" /> classes, you must set the <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.Key" /> property and <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.IV" /> property to the same values that were used for encryption.    </para><para>For a given secret key <legacyItalic>k</legacyItalic>, a simple block cipher that does not use an initialization vector will encrypt the same input block of plain text into the same output block of cipher text. If you have duplicate blocks within your plain text stream, you will have duplicate blocks within your cipher text stream. If unauthorized users know anything about the structure of a block of your plain text, they can use that information to decipher the known cipher text block and possibly recover your key. To combat this problem, information from the previous block is mixed into the process of encrypting the next block. Thus, the output of two identical plain text blocks is different. Because this technique uses the previous block to encrypt the next block, an initialization vector is needed to encrypt the first block of data. </para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Gets or sets the initialization vector (<see cref="P:System.Security.Cryptography.SymmetricAlgorithm.IV" />) for the symmetric algorithm.</para></summary></Docs></Member><Member MemberName="IVValue"><MemberSignature Language="C#" Value="protected byte[] IVValue;" /><MemberSignature Language="ILAsm" Value=".field family unsigned int8[] IVValue" /><MemberType>Field</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Byte[]</ReturnType></ReturnValue><Parameters /><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>This field is accessed through the <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.IV" /> property.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Represents the initialization vector (<see cref="P:System.Security.Cryptography.SymmetricAlgorithm.IV" />) for the symmetric algorithm.</para></summary></Docs></Member><Member MemberName="Key"><MemberSignature Language="C#" Value="public virtual byte[] Key { get; set; }" /><MemberSignature Language="ILAsm" Value=".property instance unsigned int8[] Key" /><MemberType>Property</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Byte[]</ReturnType></ReturnValue><Docs><value>To be added.</value><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>The secret key is used both for encryption and for decryption. For a symmetric algorithm to be successful, the secret key must be known only to the sender and the receiver. The valid key sizes are specified by the particular symmetric algorithm implementation and are listed in the <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.LegalKeySizes" /> property.</para><para>If this property is null when it is used, the <see cref="M:System.Security.Cryptography.SymmetricAlgorithm.GenerateKey" /> method is called to create a new random value.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Gets or sets the secret key for the symmetric algorithm.</para></summary></Docs></Member><Member MemberName="KeySize"><MemberSignature Language="C#" Value="public virtual int KeySize { get; set; }" /><MemberSignature Language="ILAsm" Value=".property instance int32 KeySize" /><MemberType>Property</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Int32</ReturnType></ReturnValue><Docs><value>To be added.</value><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>The valid key sizes are specified by the particular symmetric algorithm implementation and are listed in the <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.LegalKeySizes" /> property.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Gets or sets the size, in bits, of the secret key used by the symmetric algorithm.</para></summary></Docs></Member><Member MemberName="KeySizeValue"><MemberSignature Language="C#" Value="protected int KeySizeValue;" /><MemberSignature Language="ILAsm" Value=".field family int32 KeySizeValue" /><MemberType>Field</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Int32</ReturnType></ReturnValue><Parameters /><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>The valid key sizes are specified by the particular symmetric algorithm implementation and are listed in the <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.LegalKeySizes" /> property.</para><para>This field is accessed through the <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.KeySize" /> property.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Represents the size, in bits, of the secret key used by the symmetric algorithm.</para></summary></Docs></Member><Member MemberName="KeyValue"><MemberSignature Language="C#" Value="protected byte[] KeyValue;" /><MemberSignature Language="ILAsm" Value=".field family unsigned int8[] KeyValue" /><MemberType>Field</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Byte[]</ReturnType></ReturnValue><Parameters /><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>The secret key is used both for encryption and for decryption. For a symmetric algorithm to be successful, the secret key must be known only to the sender and the receiver. The valid key sizes are specified by the particular symmetric algorithm implementation and are listed in the <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.LegalKeySizes" /> property.</para><para>This field is accessed through the <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.Key" /> property.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Represents the secret key for the symmetric algorithm.</para></summary></Docs></Member><Member MemberName="LegalBlockSizes"><MemberSignature Language="C#" Value="public virtual System.Security.Cryptography.KeySizes[] LegalBlockSizes { get; }" /><MemberSignature Language="ILAsm" Value=".property instance class System.Security.Cryptography.KeySizes[] LegalBlockSizes" /><MemberType>Property</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Security.Cryptography.KeySizes[]</ReturnType></ReturnValue><Docs><value>To be added: an object of type 'KeySizes []'</value><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>The symmetric algorithm supports only block sizes that match an entry in this array.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Gets the block sizes, in bits, that are supported by the symmetric algorithm.</para></summary></Docs></Member><Member MemberName="LegalBlockSizesValue"><MemberSignature Language="C#" Value="protected System.Security.Cryptography.KeySizes[] LegalBlockSizesValue;" /><MemberSignature Language="ILAsm" Value=".field family class System.Security.Cryptography.KeySizes[] LegalBlockSizesValue" /><MemberType>Field</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Security.Cryptography.KeySizes[]</ReturnType></ReturnValue><Parameters /><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>The symmetric algorithm supports only block sizes that match an entry in this array.</para><para>This field is accessed through the <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.LegalBlockSizes" /> property.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Specifies the block sizes, in bits, that are supported by the symmetric algorithm.</para></summary></Docs></Member><Member MemberName="LegalKeySizes"><MemberSignature Language="C#" Value="public virtual System.Security.Cryptography.KeySizes[] LegalKeySizes { get; }" /><MemberSignature Language="ILAsm" Value=".property instance class System.Security.Cryptography.KeySizes[] LegalKeySizes" /><MemberType>Property</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Security.Cryptography.KeySizes[]</ReturnType></ReturnValue><Docs><value>To be added: an object of type 'KeySizes []'</value><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>The symmetric algorithm supports only key sizes that match an entry in this array.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Gets the key sizes, in bits, that are supported by the symmetric algorithm.</para></summary></Docs></Member><Member MemberName="LegalKeySizesValue"><MemberSignature Language="C#" Value="protected System.Security.Cryptography.KeySizes[] LegalKeySizesValue;" /><MemberSignature Language="ILAsm" Value=".field family class System.Security.Cryptography.KeySizes[] LegalKeySizesValue" /><MemberType>Field</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Security.Cryptography.KeySizes[]</ReturnType></ReturnValue><Parameters /><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>The symmetric algorithm supports only key sizes that match an entry in this array.</para><para>This field is accessed through the <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.LegalKeySizes" /> property.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Specifies the key sizes, in bits, that are supported by the symmetric algorithm.</para></summary></Docs></Member><Member MemberName="Mode"><MemberSignature Language="C#" Value="public virtual System.Security.Cryptography.CipherMode Mode { get; set; }" /><MemberSignature Language="ILAsm" Value=".property instance valuetype System.Security.Cryptography.CipherMode Mode" /><MemberType>Property</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Security.Cryptography.CipherMode</ReturnType></ReturnValue><Docs><value>To be added.</value><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>See <see cref="T:System.Security.Cryptography.CipherMode" /> enumeration for a description of specific modes.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Gets or sets the mode for operation of the symmetric algorithm.</para></summary></Docs></Member><Member MemberName="ModeValue"><MemberSignature Language="C#" Value="protected System.Security.Cryptography.CipherMode ModeValue;" /><MemberSignature Language="ILAsm" Value=".field family valuetype System.Security.Cryptography.CipherMode ModeValue" /><MemberType>Field</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Security.Cryptography.CipherMode</ReturnType></ReturnValue><Parameters /><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>See <see cref="T:System.Security.Cryptography.CipherMode" /> enumeration for a description of specific modes.</para><para>This field is accessed through the <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.Mode" /> property.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Represents the cipher mode used in the symmetric algorithm.</para></summary></Docs></Member><Member MemberName="Padding"><MemberSignature Language="C#" Value="public virtual System.Security.Cryptography.PaddingMode Padding { get; set; }" /><MemberSignature Language="ILAsm" Value=".property instance valuetype System.Security.Cryptography.PaddingMode Padding" /><MemberType>Property</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Security.Cryptography.PaddingMode</ReturnType></ReturnValue><Docs><value>To be added.</value><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>Most plain text messages do not consist of a number of bytes that completely fill blocks. Often, there are not enough bytes to fill the last block. When this happens, a padding string is added to the text. For example, if the block length is 64 bits and the last block contains only 40 bits, 24 bits of padding are added. See the <see cref="T:System.Security.Cryptography.PaddingMode" /> enumeration for a description of specific modes.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Gets or sets the padding mode used in the symmetric algorithm.</para></summary></Docs></Member><Member MemberName="PaddingValue"><MemberSignature Language="C#" Value="protected System.Security.Cryptography.PaddingMode PaddingValue;" /><MemberSignature Language="ILAsm" Value=".field family valuetype System.Security.Cryptography.PaddingMode PaddingValue" /><MemberType>Field</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Security.Cryptography.PaddingMode</ReturnType></ReturnValue><Parameters /><Docs><remarks><attribution license="cc4" from="Microsoft" modified="false" /><para>Most plain text messages do not consist of a number of bytes that completely fill blocks. Often, there are not enough bytes to fill the last block. When this happens, a padding string is added to the text. For example, if the block length is 64 bits and the last block contains only 40 bits, 24 bits of padding are added. See the <see cref="T:System.Security.Cryptography.PaddingMode" /> enumeration for a description of specific modes.</para><para>This field is accessed through the <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.Padding" /> property.</para></remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Represents the padding mode used in the symmetric algorithm.</para></summary></Docs></Member><Member MemberName="System.IDisposable.Dispose"><MemberSignature Language="C#" Value="void IDisposable.Dispose ();" /><MemberType>Method</MemberType><ReturnValue><ReturnType>System.Void</ReturnType></ReturnValue><Parameters /><Docs><remarks>To be added.</remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Releases the unmanaged resources used by the <see cref="T:System.Security.Cryptography.SymmetricAlgorithm" /> and optionally releases the managed resources. </para></summary></Docs><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion></AssemblyInfo></Member><Member MemberName="ValidKeySize"><MemberSignature Language="C#" Value="public bool ValidKeySize (int bitLength);" /><MemberSignature Language="ILAsm" Value=".method public hidebysig instance bool ValidKeySize(int32 bitLength) cil managed" /><MemberType>Method</MemberType><AssemblyInfo><AssemblyVersion>1.0.5000.0</AssemblyVersion><AssemblyVersion>2.0.0.0</AssemblyVersion><AssemblyVersion>4.0.0.0</AssemblyVersion></AssemblyInfo><ReturnValue><ReturnType>System.Boolean</ReturnType></ReturnValue><Parameters><Parameter Name="bitLength" Type="System.Int32" /></Parameters><Docs><remarks>To be added</remarks><summary><attribution license="cc4" from="Microsoft" modified="false" /><para>Determines whether the specified key size is valid for the current algorithm.</para></summary><returns><attribution license="cc4" from="Microsoft" modified="false" /><para>true if the specified key size is valid for the current algorithm; otherwise, false.</para></returns><param name="bitLength"><attribution license="cc4" from="Microsoft" modified="false" />The length, in bits, to check for a valid key size. </param></Docs></Member></Members></Type>