diff --git a/xml/System.Security.Cryptography/HMAC.xml b/xml/System.Security.Cryptography/HMAC.xml
index c2e879c1487..c6edd024f42 100644
--- a/xml/System.Security.Cryptography/HMAC.xml
+++ b/xml/System.Security.Cryptography/HMAC.xml
@@ -346,9 +346,20 @@
- To be added.
- To be added.
- To be added.
+ The input to compute the HMAC code for.
+ Routes data written to the object into the HMAC algorithm for computing the HMAC.
+
+
+because there is no managed implementation of HMAC.
+
+Derived types must override this method.
+
+ ]]>
+
+ In all cases.
@@ -388,15 +399,13 @@
The input data.
The offset into the byte array from which to begin using data.
The number of bytes in the array to use as data.
- When overridden in a derived class, routes data written to the object into the default hash algorithm for computing the hash value.
+ When overridden in a derived class, routes data written to the object into the HMAC algorithm for computing the HMAC value.
@@ -433,8 +442,8 @@
- When overridden in a derived class, finalizes the hash computation after the last data is processed by the cryptographic stream object.
- The computed hash code in a byte array.
+ When overridden in a derived class, finalizes the HMAC computation after the last data is processed by the algorithm.
+ The computed HMAC value in a byte array.
System.Byte[]
- Gets or sets the key to use in the hash algorithm.
- The key to use in the hash algorithm.
+ Gets or sets the key to use in the HMAC calculation.
+ The key to use in the HMAC calculation.
- To be added.
- To be added.
- To be added.
- To be added.
- To be added.
+ The buffer to receive the HMAC value.
+ When this method returns, the total number of bytes written into . This parameter is treated as uninitialized.
+ Attempts to finalize the HMAC computation after the last data is processed by the HMAC algorithm.
+
+ if is long enough to receive the HMAC value; otherwise, .
+
+
+because there is no managed implementation of HMAC.
+
+Derived types must override this method.
+
+ ]]>
+
+ The method is not overriden in the derived type.
diff --git a/xml/System.Security.Cryptography/HMACMD5.xml b/xml/System.Security.Cryptography/HMACMD5.xml
index 2da55cb39b8..30a59772815 100644
--- a/xml/System.Security.Cryptography/HMACMD5.xml
+++ b/xml/System.Security.Cryptography/HMACMD5.xml
@@ -199,8 +199,9 @@
- To be added.
- To be added.
+
+ to release both managed and unmanaged resources; to release only unmanaged resources.
+ Releases the unmanaged resources used by the and optionally releases the managed resources.
To be added.
@@ -230,8 +231,8 @@
- To be added.
- To be added.
+ The input to compute the HMAC for.
+ Routes data written to the object into the HMAC algorithm for computing the HMAC.
To be added.
@@ -267,10 +268,10 @@
- To be added.
- To be added.
- To be added.
- To be added.
+ The input to compute the HMAC for.
+ The offset into the byte array from which to begin using data.
+ The number of bytes in the byte array to use as data.
+ Routes data written to the object into the HMAC algorithm for computing the HMAC.
To be added.
@@ -302,8 +303,8 @@
- To be added.
- To be added.
+ Finalizes the HMAC computation after the last data is processed by the algorithm.
+ The computed HMAC value in a byte array.
To be added.
@@ -331,8 +332,8 @@
System.Int32
- To be added.
- To be added.
+ Gets the size, in bits, of the computed HMAC.
+ The size, in bits, of the computed HMAC.
To be added.
@@ -364,7 +365,7 @@
- To be added.
+ Resets the hash algorithm to its initial state.
To be added.
@@ -395,8 +396,8 @@
System.Byte[]
- To be added.
- To be added.
+ Gets or sets the key to use in the HMAC calculation.
+ The key to use in the HMAC calculation.
To be added.
@@ -427,10 +428,11 @@
- To be added.
- To be added.
- To be added.
- To be added.
+ The buffer to receive the HMAC value.
+ When this method returns, the total number of bytes written into . This parameter is treated as uninitialized.
+ Attempts to finalize the HMAC computation after the last data is processed by the HMAC algorithm.
+
+ if is long enough to receive the HMAC value; otherwise, .
To be added.
diff --git a/xml/System.Security.Cryptography/HMACSHA1.xml b/xml/System.Security.Cryptography/HMACSHA1.xml
index f78832de34c..5a4ecc77e35 100644
--- a/xml/System.Security.Cryptography/HMACSHA1.xml
+++ b/xml/System.Security.Cryptography/HMACSHA1.xml
@@ -316,8 +316,8 @@ Releases the unmanaged resources used by the
- To be added.
- To be added.
+ The input to compute the HMAC for.
+ Routes data written to the object into the HMAC algorithm for computing the HMAC.
To be added.
@@ -390,8 +390,8 @@ Releases the unmanaged resources used by the System.Int32
- To be added.
- To be added.
+ Gets the size, in bits, of the computed HMAC.
+ The size, in bits, of the computed HMAC.
To be added.
@@ -480,7 +480,7 @@ Releases the unmanaged resources used by the .
+ Resets the hash algorithm to its initial state.
To be added.
@@ -544,10 +544,11 @@ Releases the unmanaged resources used by the
- To be added.
- To be added.
- To be added.
- To be added.
+ The buffer to receive the HMAC value.
+ When this method returns, the total number of bytes written into . This parameter is treated as uninitialized.
+ Attempts to finalize the HMAC computation after the last data is processed by the HMAC algorithm.
+
+ if is long enough to receive the HMAC value; otherwise, .
To be added.
diff --git a/xml/System.Security.Cryptography/HMACSHA256.xml b/xml/System.Security.Cryptography/HMACSHA256.xml
index a84474290fd..5f07c9f7649 100644
--- a/xml/System.Security.Cryptography/HMACSHA256.xml
+++ b/xml/System.Security.Cryptography/HMACSHA256.xml
@@ -195,8 +195,9 @@
- To be added.
- To be added.
+
+ to release both managed and unmanaged resources; to release only unmanaged resources.
+ Releases the unmanaged resources used by the and optionally releases the managed resources.
To be added.
@@ -226,8 +227,8 @@
- To be added.
- To be added.
+ The input to compute the HMAC for.
+ Routes data written to the object into the HMAC algorithm for computing the HMAC.
To be added.
@@ -263,10 +264,10 @@
- To be added.
- To be added.
- To be added.
- To be added.
+ The input to compute the HMAC for.
+ The offset into the byte array from which to begin using data.
+ The number of bytes in the byte array to use as data.
+ Routes data written to the object into the HMAC algorithm for computing the HMAC.
To be added.
@@ -298,8 +299,8 @@
- To be added.
- To be added.
+ Finalizes the HMAC computation after the last data is processed by the algorithm.
+ The computed HMAC value in a byte array.
To be added.
@@ -327,8 +328,8 @@
System.Int32
- To be added.
- To be added.
+ Gets the size, in bits, of the computed HMAC.
+ The size, in bits, of the computed HMAC.
To be added.
@@ -360,7 +361,7 @@
- To be added.
+ Resets the hash algorithm to its initial state.
To be added.
@@ -391,8 +392,8 @@
System.Byte[]
- To be added.
- To be added.
+ Gets or sets the key to use in the HMAC calculation.
+ The key to use in the HMAC calculation.
To be added.
@@ -423,10 +424,11 @@
- To be added.
- To be added.
- To be added.
- To be added.
+ The buffer to receive the HMAC value.
+ When this method returns, the total number of bytes written into . This parameter is treated as uninitialized.
+ Attempts to finalize the HMAC computation after the last data is processed by the HMAC algorithm.
+
+ if is long enough to receive the HMAC value; otherwise, .
To be added.
diff --git a/xml/System.Security.Cryptography/HMACSHA384.xml b/xml/System.Security.Cryptography/HMACSHA384.xml
index 60caa40cac3..05835f56798 100644
--- a/xml/System.Security.Cryptography/HMACSHA384.xml
+++ b/xml/System.Security.Cryptography/HMACSHA384.xml
@@ -193,8 +193,9 @@
- To be added.
- To be added.
+
+ to release both managed and unmanaged resources; to release only unmanaged resources.
+ Releases the unmanaged resources used by the and optionally releases the managed resources.
To be added.
@@ -224,8 +225,8 @@
- To be added.
- To be added.
+ The input to compute the HMAC for.
+ Routes data written to the object into the HMAC algorithm for computing the HMAC.
To be added.
@@ -261,10 +262,10 @@
- To be added.
- To be added.
- To be added.
- To be added.
+ The input to compute the HMAC for.
+ The offset into the byte array from which to begin using data.
+ The number of bytes in the byte array to use as data.
+ Routes data written to the object into the HMAC algorithm for computing the HMAC.
To be added.
@@ -296,8 +297,8 @@
- To be added.
- To be added.
+ Finalizes the HMAC computation after the last data is processed by the algorithm.
+ The computed HMAC value in a byte array.
To be added.
@@ -325,8 +326,8 @@
System.Int32
- To be added.
- To be added.
+ Gets the size, in bits, of the computed HMAC.
+ The size, in bits, of the computed HMAC.
To be added.
@@ -358,7 +359,7 @@
- To be added.
+ Resets the hash algorithm to its initial state.
To be added.
@@ -389,8 +390,8 @@
System.Byte[]
- To be added.
- To be added.
+ Gets or sets the key to use in the HMAC calculation.
+ The key to use in the HMAC calculation.
To be added.
@@ -475,10 +476,11 @@ public static void Test()
- To be added.
- To be added.
- To be added.
- To be added.
+ The buffer to receive the HMAC value.
+ When this method returns, the total number of bytes written into . This parameter is treated as uninitialized.
+ Attempts to finalize the HMAC computation after the last data is processed by the HMAC algorithm.
+
+ if is long enough to receive the HMAC value; otherwise, .
To be added.
diff --git a/xml/System.Security.Cryptography/HMACSHA512.xml b/xml/System.Security.Cryptography/HMACSHA512.xml
index 9fe856543de..fcf61fbe46c 100644
--- a/xml/System.Security.Cryptography/HMACSHA512.xml
+++ b/xml/System.Security.Cryptography/HMACSHA512.xml
@@ -193,8 +193,9 @@
- To be added.
- To be added.
+
+ to release both managed and unmanaged resources; to release only unmanaged resources.
+ Releases the unmanaged resources used by the and optionally releases the managed resources.
To be added.
@@ -224,8 +225,8 @@
- To be added.
- To be added.
+ The input to compute the HMAC for.
+ Routes data written to the object into the HMAC algorithm for computing the HMAC.
To be added.
@@ -261,10 +262,10 @@
- To be added.
- To be added.
- To be added.
- To be added.
+ The input to compute the HMAC for.
+ The offset into the byte array from which to begin using data.
+ The number of bytes in the byte array to use as data.
+ Routes data written to the object into the HMAC algorithm for computing the HMAC.
To be added.
@@ -296,8 +297,8 @@
- To be added.
- To be added.
+ Finalizes the HMAC computation after the last data is processed by the algorithm.
+ The computed HMAC value in a byte array.
To be added.
@@ -325,8 +326,8 @@
System.Int32
- To be added.
- To be added.
+ Gets the size, in bits, of the computed HMAC.
+ The size, in bits, of the computed HMAC.
To be added.
@@ -358,7 +359,7 @@
- To be added.
+ Resets the hash algorithm to its initial state.
To be added.
@@ -389,8 +390,8 @@
System.Byte[]
- To be added.
- To be added.
+ Gets or sets the key to use in the HMAC calculation.
+ The key to use in the HMAC calculation.
To be added.
@@ -475,10 +476,11 @@ public static void Test()
- To be added.
- To be added.
- To be added.
- To be added.
+ The buffer to receive the HMAC value.
+ When this method returns, the total number of bytes written into . This parameter is treated as uninitialized.
+ Attempts to finalize the HMAC computation after the last data is processed by the HMAC algorithm.
+
+ if is long enough to receive the HMAC value; otherwise, .
To be added.
diff --git a/xml/System.Security.Cryptography/HashAlgorithm.xml b/xml/System.Security.Cryptography/HashAlgorithm.xml
index fe9c262825f..bbf9e13f268 100644
--- a/xml/System.Security.Cryptography/HashAlgorithm.xml
+++ b/xml/System.Security.Cryptography/HashAlgorithm.xml
@@ -714,9 +714,18 @@ The following example calculates the
- To be added.
- To be added.
- To be added.
+ The input to compute the hash code for.
+ Routes data written to the object into the hash algorithm for computing the hash.
+
+ .
+
+Derived types should override this method to avoid the intermediate data copying.
+
+ ]]>
+
@@ -764,7 +773,7 @@ The following example calculates the
## Remarks
This method is not called by application code.
- This abstract method performs the hash computation. Every write to the cryptographic stream object passes the data through this method. For each block of data, this method updates the state of the hash object so a correct hash value is returned at the end of the data stream.
+ This abstract method performs the hash computation. Every write to the cryptographic hash algorithm passes the data through this method. For each block of data, this method updates the state of the hash object so a correct hash value is returned at the end of the data.
]]>
@@ -801,13 +810,13 @@ The following example calculates the
- When overridden in a derived class, finalizes the hash computation after the last data is processed by the cryptographic stream object.
+ When overridden in a derived class, finalizes the hash computation after the last data is processed by the cryptographic hash algorithm.
The computed hash code.
@@ -965,7 +974,7 @@ The following example calculates the
- Initializes an implementation of the class.
+ Resets the hash algorithm to its initial state.
To be added.
@@ -1333,11 +1342,12 @@ For more information about Dispose and Finalize, see [Cleaning Up Unmanaged Reso
- To be added.
- To be added.
- To be added.
- To be added.
- To be added.
+ The input to compute the hash code for.
+ The buffer to receive the hash value.
+ When this method returns, the total number of bytes written into . This parameter is treated as uninitialized.
+ Attempts to compute the hash value for the specified byte array.
+
+ if is long enough to receive the hash value; otherwise, .
To be added.
@@ -1368,11 +1378,24 @@ For more information about Dispose and Finalize, see [Cleaning Up Unmanaged Reso
- To be added.
- To be added.
- To be added.
- To be added.
- To be added.
+ The buffer to receive the hash value.
+ When this method returns, the total number of bytes written into . This parameter is treated as uninitialized.
+ Attempts to finalize the hash computation after the last data is processed by the hash algorithm.
+
+ if is long enough to receive the hash value; otherwise, .
+
+ and copy the result to `destination`.
+
+Derived types should override this method to avoid the intermediate array creation.
+
+All calls to this method by the class have already verified that `destination` is long enough based on the property,
+so `false` return values are unexpected.
+
+ ]]>
+
diff --git a/xml/System.Security.Cryptography/IncrementalHash.xml b/xml/System.Security.Cryptography/IncrementalHash.xml
index df5624d9fcf..f74d08ffac4 100644
--- a/xml/System.Security.Cryptography/IncrementalHash.xml
+++ b/xml/System.Security.Cryptography/IncrementalHash.xml
@@ -152,9 +152,10 @@
- To be added.
- To be added.
+ The data to process.
+ Appends the specified data to the data already processed in the hash or Hash-based Message Authentication Code (HMAC).
To be added.
+ The object has already been disposed.
@@ -383,7 +384,7 @@
- Retrieves the hash or Hash-based Message Authentication Code (HMAC) for the data accumulated from prior calls to the method, and resets the object to its initial state.
+ Retrieves the hash or Hash-based Message Authentication Code (HMAC) for the data accumulated from prior calls to the methods, and resets the object to its initial state.
The computed hash or HMAC.
To be added.
The object has already been disposed.
@@ -416,11 +417,12 @@
- To be added.
- To be added.
- To be added.
- To be added.
- To be added.
+ The buffer to receive the hash or Hash-Based Message Authentication Code (HMAC) value.
+ When this method returns, the total number of bytes written into . This parameter is treated as uninitialized.
+ Attempts to finalize the hash computation after the last data is processed by the hash algorithm.
+ Attempts to retrieve the hash or Hash-based Message Authentication Code (HMAC) for the data accumulated from prior calls to the methods, and resets the object to its initial state.
+ if is long enough to receive the hash or HMAC value; otherwise, .
+ The object has already been disposed.
diff --git a/xml/System.Security.Cryptography/SHA1Managed.xml b/xml/System.Security.Cryptography/SHA1Managed.xml
index 8dc6490fab3..5119403d133 100644
--- a/xml/System.Security.Cryptography/SHA1Managed.xml
+++ b/xml/System.Security.Cryptography/SHA1Managed.xml
@@ -160,7 +160,7 @@ This method is called by the public
- To be added.
+ Frees resources and performs other cleanup operations for this object before it is reclaimed by garbage collection.
To be added.
@@ -192,8 +192,8 @@ This method is called by the public
- To be added.
- To be added.
+ The input to compute the hash code for.
+ Routes data written to the object into the hash algorithm for computing the hash.
To be added.
@@ -362,10 +362,11 @@ This method is called by the public
- To be added.
- To be added.
- To be added.
- To be added.
+ The buffer to receive the hash value.
+ When this method returns, the total number of bytes written into . This parameter is treated as uninitialized.
+ Attempts to finalize the hash computation after the last data is processed by the hash algorithm.
+
+ if is long enough to receive the hash value; otherwise, .
To be added.
diff --git a/xml/System.Security.Cryptography/SHA256Managed.xml b/xml/System.Security.Cryptography/SHA256Managed.xml
index 2e1721d32c8..2fa8de4a989 100644
--- a/xml/System.Security.Cryptography/SHA256Managed.xml
+++ b/xml/System.Security.Cryptography/SHA256Managed.xml
@@ -171,7 +171,7 @@ This method is called by the public System.Void
- To be added.
+ Frees resources and performs other cleanup operations for this object before it is reclaimed by garbage collection.
To be added.
@@ -203,8 +203,8 @@ This method is called by the public
- To be added.
- To be added.
+ The input to compute the hash code for.
+ Routes data written to the object into the hash algorithm for computing the hash.
To be added.
@@ -398,10 +398,11 @@ This method is called by the public
- To be added.
- To be added.
- To be added.
- To be added.
+ The buffer to receive the hash value.
+ When this method returns, the total number of bytes written into . This parameter is treated as uninitialized.
+ Attempts to finalize the hash computation after the last data is processed by the hash algorithm.
+
+ if is long enough to receive the hash value; otherwise, .
To be added.
diff --git a/xml/System.Security.Cryptography/SHA384Managed.xml b/xml/System.Security.Cryptography/SHA384Managed.xml
index b29e04b6dd5..46297b526f6 100644
--- a/xml/System.Security.Cryptography/SHA384Managed.xml
+++ b/xml/System.Security.Cryptography/SHA384Managed.xml
@@ -172,7 +172,7 @@ This method is called by the public
- To be added.
+ Frees resources and performs other cleanup operations for this object before it is reclaimed by garbage collection.
To be added.
@@ -204,8 +204,8 @@ This method is called by the public
- To be added.
- To be added.
+ The input to compute the hash code for.
+ Routes data written to the object into the hash algorithm for computing the hash.
To be added.
@@ -409,10 +409,11 @@ This method is called by the public
- To be added.
- To be added.
- To be added.
- To be added.
+ The buffer to receive the hash value.
+ When this method returns, the total number of bytes written into . This parameter is treated as uninitialized.
+ Attempts to finalize the hash computation after the last data is processed by the hash algorithm.
+
+ if is long enough to receive the hash value; otherwise, .
To be added.
diff --git a/xml/System.Security.Cryptography/SHA512Managed.xml b/xml/System.Security.Cryptography/SHA512Managed.xml
index 5fc5d326aa9..b90b1c00ecf 100644
--- a/xml/System.Security.Cryptography/SHA512Managed.xml
+++ b/xml/System.Security.Cryptography/SHA512Managed.xml
@@ -170,7 +170,7 @@ This method is called by the public
- To be added.
+ Frees resources and performs other cleanup operations for this object before it is reclaimed by garbage collection.
To be added.
@@ -202,8 +202,8 @@ This method is called by the public
- To be added.
- To be added.
+ The input to compute the hash code for.
+ Routes data written to the object into the hash algorithm for computing the hash.
To be added.
@@ -407,10 +407,11 @@ This method is called by the public
- To be added.
- To be added.
- To be added.
- To be added.
+ The buffer to receive the hash value.
+ When this method returns, the total number of bytes written into . This parameter is treated as uninitialized.
+ Attempts to finalize the hash computation after the last data is processed by the hash algorithm.
+
+ if is long enough to receive the hash value; otherwise, .
To be added.