Windows Azure Storage client 2.0.0.0

Update from master

Author: joe giardino

microsoft-azure-api/Services/Storage/Lib/Common/AccessCondition.cs

@@ -37,7 +37,7 @@ public sealed class AccessCondition
         /// <summary>
         /// Gets or sets an "etag" that must match the ETag of a resource.
         /// </summary>
-        /// <value>A quoted ETag string. If <code>null</code>, no condition exists.</value>
+        /// <value>A quoted ETag string. If <c>null</c>, no condition exists.</value>
         public string IfMatchETag
         {
             get;

microsoft-azure-api/Services/Storage/Lib/Common/Auth/StorageCredentials.cs

@@ -53,7 +53,7 @@ public sealed class StorageCredentials
         /// <summary>
         /// Gets a value indicating whether the credentials are for anonymous access.
         /// </summary>
-        /// <value><code>true</code> if the credentials are for anonymous access; otherwise, <code>false</code>.</value>
+        /// <value><c>true</c> if the credentials are for anonymous access; otherwise, <c>false</c>.</value>
         public bool IsAnonymous
         {
             get
@@ -65,7 +65,7 @@ public bool IsAnonymous
         /// <summary>
         /// Gets a value indicating whether the credentials are a shared access signature token.
         /// </summary>
-        /// <value><code>true</code> if the credentials are a shared access signature token; otherwise, <code>false</code>.</value>
+        /// <value><c>true</c> if the credentials are a shared access signature token; otherwise, <c>false</c>.</value>
         public bool IsSAS
         {
             get
@@ -77,7 +77,7 @@ public bool IsSAS
         /// <summary>
         /// Gets a value indicating whether the credentials are a shared key.
         /// </summary>
-        /// <value><code>true</code> if the credentials are a shared key; otherwise, <code>false</code>.</value>
+        /// <value><c>true</c> if the credentials are a shared key; otherwise, <c>false</c>.</value>
         public bool IsSharedKey
         {
             get
@@ -262,7 +262,7 @@ internal string ToString(bool exportSecrets)
         /// Determines whether an other <see cref="StorageCredentials"/> object is equal to this one by comparing their SAS tokens, account names, key names, and key values.
         /// </summary>
         /// <param name="other">The <see cref="StorageCredentials"/> object to compare to this one.</param>
-        /// <returns><code>true</code> if the two <see cref="StorageCredentials"/> objects are equal; otherwise, <code>false</code>.</returns>
+        /// <returns><c>true</c> if the two <see cref="StorageCredentials"/> objects are equal; otherwise, <c>false</c>.</returns>
         public bool Equals(StorageCredentials other)
         {
             if (other == null)

microsoft-azure-api/Services/Storage/Lib/Common/Blob/BlobContinuationToken.cs

@@ -29,7 +29,7 @@ namespace Microsoft.WindowsAzure.Storage.Blob
     /// <summary>
     /// Represents a continuation token for listing operations. 
     /// </summary>
-    /// <remarks> <see cref="BlobContinuationToken"/> continuation tokens are used in methods that return a <see cref="BlobResultSegment"/> object, such as <see cref="CloudBlobDirectory.listBlobsSegmented()"/>.</remarks>
+    /// <remarks> <see cref="BlobContinuationToken"/> continuation tokens are used in methods that return a <see cref="BlobResultSegment"/> object, such as <see cref="CloudBlobDirectory.ListBlobsSegmented(BlobContinuationToken)"/>.</remarks>
     [SuppressMessage("StyleCop.CSharp.SpacingRules", "SA1001:CommasMustBeSpacedCorrectly", Justification = "Reviewed.")]
     public sealed class BlobContinuationToken : IContinuationToken
 #if DNCP

microsoft-azure-api/Services/Storage/Lib/Common/Blob/BlobReadStreamBase.cs

@@ -43,6 +43,7 @@ internal abstract class BlobReadStreamBase : Stream
         /// <param name="blob">Blob reference to read from</param>
         /// <param name="accessCondition">An object that represents the access conditions for the blob. If null, no condition is used.</param>
         /// <param name="options">An object that specifies any additional options for the request.</param>
+        /// <param name="operationContext">An <see cref="OperationContext"/> object for tracking the current operation.</param>
         protected BlobReadStreamBase(ICloudBlob blob, AccessCondition accessCondition, BlobRequestOptions options, OperationContext operationContext)
         {
             this.blob = blob;

microsoft-azure-api/Services/Storage/Lib/Common/Blob/BlobRequestOptions.cs

@@ -87,7 +87,7 @@ internal static BlobRequestOptions ApplyDefaults(BlobRequestOptions options, Blo
         /// <summary>
         /// Gets or sets a value to calculate and send/validate content MD5 for transactions.
         /// </summary>
-        /// <value>Use <code>true</code> to calculate and send/validate content MD5 for transactions; otherwise, <code>false</code>.</value>
+        /// <value>Use <c>true</c> to calculate and send/validate content MD5 for transactions; otherwise, <c>false</c>.</value>
         public bool? UseTransactionalMD5 { get; set; }
 
         /// <summary>

microsoft-azure-api/Services/Storage/Lib/Common/Blob/BlobWriteStreamBase.cs

@@ -49,10 +49,9 @@ internal abstract class BlobWriteStreamBase : Stream
         /// <summary>
         /// Initializes a new instance of the BlobWriteStreamBase class.
         /// </summary>
-        /// <param name="blobType">Type of the target blob.</param>
-        /// <param name="blob">Blob reference to write to.</param>
         /// <param name="accessCondition">An object that represents the access conditions for the blob. If null, no condition is used.</param>
         /// <param name="options">An object that specifies any additional options for the request.</param>
+        /// <param name="operationContext">An <see cref="OperationContext"/> object for tracking the current operation.</param>
         private BlobWriteStreamBase(CloudBlobClient serviceClient, AccessCondition accessCondition, BlobRequestOptions options, OperationContext operationContext)
             : base()
         {
@@ -74,6 +73,7 @@ private BlobWriteStreamBase(CloudBlobClient serviceClient, AccessCondition acces
         /// <param name="blockBlob">Blob reference to write to.</param>
         /// <param name="accessCondition">An object that represents the access conditions for the blob. If null, no condition is used.</param>
         /// <param name="options">An object that specifies any additional options for the request.</param>
+        /// <param name="operationContext">An <see cref="OperationContext"/> object for tracking the current operation.</param>
         protected BlobWriteStreamBase(CloudBlockBlob blockBlob, AccessCondition accessCondition, BlobRequestOptions options, OperationContext operationContext)
             : this(blockBlob.ServiceClient, accessCondition, options, operationContext)
         {
@@ -90,6 +90,7 @@ protected BlobWriteStreamBase(CloudBlockBlob blockBlob, AccessCondition accessCo
         /// <param name="pageBlobSize">Size of the page blob.</param>
         /// <param name="accessCondition">An object that represents the access conditions for the blob. If null, no condition is used.</param>
         /// <param name="options">An object that specifies any additional options for the request.</param>
+        /// <param name="operationContext">An <see cref="OperationContext"/> object for tracking the current operation.</param>
         protected BlobWriteStreamBase(CloudPageBlob pageBlob, long pageBlobSize, AccessCondition accessCondition, BlobRequestOptions options, OperationContext operationContext)
             : this(pageBlob.ServiceClient, accessCondition, options, operationContext)
         {

microsoft-azure-api/Services/Storage/Lib/Common/Blob/CloudBlobContainerBase.cs

@@ -66,7 +66,7 @@ internal CloudBlobContainer(string containerName, CloudBlobClient serviceClient)
         /// Initializes a new instance of the <see cref="CloudBlobContainer"/> class.
         /// </summary>
         /// <param name="containerName">The container name.</param>
-        /// <param name="client">The client to be used.</param>
+        /// <param name="serviceClient">The client to be used.</param>
         internal CloudBlobContainer(BlobContainerProperties properties, IDictionary<string, string> metadata, string containerName, CloudBlobClient serviceClient)
         {
             this.Uri = NavigationHelper.AppendPathToUri(serviceClient.BaseUri, containerName);

microsoft-azure-api/Services/Storage/Lib/Common/Blob/CloudBlobDirectoryBase.cs

@@ -44,7 +44,7 @@ public sealed partial class CloudBlobDirectory : IListBlobItem
         /// <summary>
         /// Initializes a new instance of the <see cref="CloudBlobDirectory"/> class given an address and a client.
         /// </summary>
-        /// <param name="address">The blob directory's address.</param>
+        /// <param name="absolutePath">The blob directory's address.</param>
         /// <param name="service">The client to use.</param>
         internal CloudBlobDirectory(string absolutePath, CloudBlobClient service)
         {

microsoft-azure-api/Services/Storage/Lib/Common/Blob/SharedAccessBlobPolicies.cs

@@ -46,7 +46,7 @@ public void Add(string key, SharedAccessBlobPolicy value)
         /// Determines whether the collection of shared access policies contains the specified key.
         /// </summary>
         /// <param name="key">The key to locate in the collection of shared access policies.</param>
-        /// <returns><code>true</code> if the collection of shared access policies contains an element with the specified key; otherwise, <code>false</code>.</returns>
+        /// <returns><c>true</c> if the collection of shared access policies contains an element with the specified key; otherwise, <c>false</c>.</returns>
         public bool ContainsKey(string key)
         {
             return this.policies.ContainsKey(key);
@@ -68,7 +68,7 @@ public ICollection<string> Keys
         /// Removes the value with the specified key from the shared access policies collection.
         /// </summary>
         /// <param name="key">The key of the <see cref="SharedAccessBlobPolicy"/> item to remove.</param>
-        /// <returns><code>true</code> if the element is successfully found and removed; otherwise, <code>false</code>. This method returns <code>false</code> if the key is not found.</returns>
+        /// <returns><c>true</c> if the element is successfully found and removed; otherwise, <c>false</c>. This method returns <c>false</c> if the key is not found.</returns>
         public bool Remove(string key)
         {
             return this.policies.Remove(key);
@@ -101,7 +101,7 @@ public ICollection<SharedAccessBlobPolicy> Values
         /// Gets or sets the <see cref="SharedAccessBlobPolicy"/> item associated with the specified key.
         /// </summary>
         /// <param name="key">The key of the <see cref="SharedAccessBlobPolicy"/> value to get or set.</param>
-        /// <returns>The <see cref="SharedAccessBlobPolicy"/> item associated with the specified key, or <code>null</code> if key is not in the shared access policies collection.</returns>
+        /// <returns>The <see cref="SharedAccessBlobPolicy"/> item associated with the specified key, or <c>null</c> if key is not in the shared access policies collection.</returns>
         public SharedAccessBlobPolicy this[string key]
         {
             get
@@ -136,7 +136,7 @@ public void Clear()
         /// Determines whether the collection of shared access policies contains the key and <see cref="SharedAccessBlobPolicy"/> value in the specified <see cref="KeyValuePair{TKey,TValue}"/> object.
         /// </summary>
         /// <param name="item">A <see cref="KeyValuePair{TKey,TValue}"/> object containing the key and <see cref="SharedAccessBlobPolicy"/> value to search for.</param>
-        /// <returns><code>true</code> if the shared access policies collection contains the specified key/value; otherwise, <code>false</code>.</returns>
+        /// <returns><c>true</c> if the shared access policies collection contains the specified key/value; otherwise, <c>false</c>.</returns>
         public bool Contains(KeyValuePair<string, SharedAccessBlobPolicy> item)
         {
             SharedAccessBlobPolicy storedItem;
@@ -182,7 +182,7 @@ public int Count
         /// <summary>
         /// Gets a value indicating whether the collection of shared access policies is read-only. 
         /// </summary>
-        /// <value><code>true</code> if the collection of shared access policies is read-only; otherwise, <code>false</code>.</value>
+        /// <value><c>true</c> if the collection of shared access policies is read-only; otherwise, <c>false</c>.</value>
         public bool IsReadOnly
         {
             get
@@ -195,7 +195,7 @@ public bool IsReadOnly
         /// Removes the <see cref="SharedAccessBlobPolicy"/> value, specified in the <see cref="KeyValuePair{TKey,TValue}"/> object, from the shared access policies collection.
         /// </summary>
         /// <param name="item">The <see cref="KeyValuePair{TKey,TValue}"/> object, containing a key and <see cref="SharedAccessBlobPolicy"/> value, to remove from the shared access policies collection.</param>
-        /// <returns><code>true</code> if the item was successfully removed; otherwise, <code>false</code>.</returns>
+        /// <returns><c>true</c> if the item was successfully removed; otherwise, <c>false</c>.</returns>
         public bool Remove(KeyValuePair<string, SharedAccessBlobPolicy> item)
         {
             if (this.Contains(item))
@@ -220,7 +220,7 @@ public IEnumerator<KeyValuePair<string, SharedAccessBlobPolicy>> GetEnumerator()
         /// <summary>
         /// Returns an enumerator that iterates through the collection of shared access policies.
         /// </summary>
-        /// <returns>An <see cref="IEnumerator"/> object that can be used to iterate through the collection of shared access policies.</returns>
+        /// <returns>An <see cref="System.Collections.IEnumerator"/> object that can be used to iterate through the collection of shared access policies.</returns>
         System.Collections.IEnumerator System.Collections.IEnumerable.GetEnumerator()
         {
             System.Collections.IEnumerable enumerable = this.policies;