Permalink
Browse files

Windows Azure Storage Client Library 2.1.0.0

  • Loading branch information...
1 parent 97996a2 commit de9e55823daf571a0ca7079a6b1562874ace39b7 Serdar Ozler committed Aug 29, 2013
Showing with 12,944 additions and 626 deletions.
  1. +13 −7 microsoft-azure-api/Services/Storage/CustomDictionary.xml
  2. +10 −10 microsoft-azure-api/Services/Storage/Lib/Common/AccessCondition.cs
  3. +8 −8 microsoft-azure-api/Services/Storage/Lib/Common/Auth/StorageCredentials.cs
  4. +1 −1 microsoft-azure-api/Services/Storage/Lib/Common/Blob/BlobContainerPublicAccessType.cs
  5. +1 −1 microsoft-azure-api/Services/Storage/Lib/Common/Blob/BlobProperties.cs
  6. +11 −12 microsoft-azure-api/Services/Storage/Lib/Common/Blob/BlobRequestOptions.cs
  7. +2 −2 microsoft-azure-api/Services/Storage/Lib/Common/Blob/BlobResultSegment.cs
  8. +7 −5 microsoft-azure-api/Services/Storage/Lib/Common/Blob/CloudBlobClient.Common.cs
  9. +4 −2 microsoft-azure-api/Services/Storage/Lib/Common/Blob/CloudBlobContainer.Common.cs
  10. +8 −9 microsoft-azure-api/Services/Storage/Lib/Common/Blob/CloudBlockBlob.Common.cs
  11. +8 −9 microsoft-azure-api/Services/Storage/Lib/Common/Blob/CloudPageBlob.Common.cs
  12. +2 −2 microsoft-azure-api/Services/Storage/Lib/Common/Blob/CopyState.cs
  13. +4 −2 microsoft-azure-api/Services/Storage/Lib/Common/Blob/ICloudBlob.Common.cs
  14. +2 −2 microsoft-azure-api/Services/Storage/Lib/Common/Blob/IListBlobItem.cs
  15. +8 −1 microsoft-azure-api/Services/Storage/Lib/Common/CloudStorageAccount.cs
  16. +16 −4 microsoft-azure-api/Services/Storage/Lib/Common/Core/Auth/SharedAccessSignatureHelper.cs
  17. +0 −2 microsoft-azure-api/Services/Storage/Lib/Common/Core/Logger.Common.cs
  18. +3 −5 microsoft-azure-api/Services/Storage/Lib/Common/Core/MultiBufferMemoryStream.cs
  19. +2 −0 microsoft-azure-api/Services/Storage/Lib/Common/Core/SR.cs
  20. +1 −1 microsoft-azure-api/Services/Storage/Lib/Common/Core/Util/AuthenticationUtility.cs
  21. +29 −13 microsoft-azure-api/Services/Storage/Lib/Common/Core/Util/HttpWebUtility.cs
  22. +3 −3 microsoft-azure-api/Services/Storage/Lib/Common/Core/Util/NavigationHelper.cs
  23. +5 −4 microsoft-azure-api/Services/Storage/Lib/Common/IBufferManager.cs
  24. +2 −1 microsoft-azure-api/Services/Storage/Lib/Common/IContinuationToken.cs
  25. +0 −2 microsoft-azure-api/Services/Storage/Lib/Common/LogLevel.cs
  26. +2 −8 microsoft-azure-api/Services/Storage/Lib/Common/OperationContext.cs
  27. +3 −3 microsoft-azure-api/Services/Storage/Lib/Common/Queue/CloudQueue.Common.cs
  28. +5 −4 microsoft-azure-api/Services/Storage/Lib/Common/Queue/CloudQueueClient.Common.cs
  29. +4 −4 microsoft-azure-api/Services/Storage/Lib/Common/Queue/QueueRequestOptions.cs
  30. +1 −1 microsoft-azure-api/Services/Storage/Lib/Common/Queue/QueueResultSegment.cs
  31. +4 −11 microsoft-azure-api/Services/Storage/Lib/Common/RetryPolicies/ExponentialRetry.cs
  32. +33 −10 microsoft-azure-api/Services/Storage/Lib/Common/Shared/Protocol/Constants.cs
  33. +7 −7 microsoft-azure-api/Services/Storage/Lib/Common/StorageException.cs
  34. +4 −4 microsoft-azure-api/Services/Storage/Lib/Common/StorageExtendedErrorInformation.cs
  35. +5 −4 microsoft-azure-api/Services/Storage/Lib/Common/Table/CloudTable.Common.cs
  36. +21 −19 microsoft-azure-api/Services/Storage/Lib/Common/Table/CloudTableClient.Common.cs
  37. +8 −8 microsoft-azure-api/Services/Storage/Lib/Common/Table/DynamicTableEntity.cs
  38. +9 −5 microsoft-azure-api/Services/Storage/Lib/Common/Table/EntityProperty.cs
  39. +3 −3 microsoft-azure-api/Services/Storage/Lib/Common/Table/ITableEntity.cs
  40. +35 −0 microsoft-azure-api/Services/Storage/Lib/Common/Table/Queryable/TableQueryableExtensions.cs
  41. +2 −2 microsoft-azure-api/Services/Storage/Lib/Common/Table/TableBatchOperation.Common.cs
  42. +41 −13 microsoft-azure-api/Services/Storage/Lib/Common/Table/TableEntity.cs
  43. +24 −13 microsoft-azure-api/Services/Storage/Lib/Common/Table/TableOperation.Common.cs
  44. +1 −1 microsoft-azure-api/Services/Storage/Lib/Common/Table/TablePermissions.cs
  45. +2 −1 microsoft-azure-api/Services/Storage/Lib/Common/Table/TableQuery.Common.cs
  46. +4 −4 microsoft-azure-api/Services/Storage/Lib/Common/Table/TableRequestOptions.cs
  47. +2 −2 microsoft-azure-api/Services/Storage/Lib/Common/Table/TableResult.cs
  48. +1 −1 microsoft-azure-api/Services/Storage/Lib/Common/Table/TableResultSegment.cs
  49. +1 −1 microsoft-azure-api/Services/Storage/Lib/DotNet40/Properties/AssemblyInfo.cs
  50. +1 −1 microsoft-azure-api/Services/Storage/Lib/DotNet40/WindowsAzure.Storage.nuspec
  51. +6 −7 microsoft-azure-api/Services/Storage/Lib/DotNetCommon/Blob/BlobWriteStream.cs
  52. +23 −22 microsoft-azure-api/Services/Storage/Lib/DotNetCommon/Blob/CloudBlobClient.cs
  53. +16 −16 microsoft-azure-api/Services/Storage/Lib/DotNetCommon/Blob/CloudBlobContainer.cs
  54. +15 −15 microsoft-azure-api/Services/Storage/Lib/DotNetCommon/Blob/CloudBlobDirectory.cs
  55. +1 −1 microsoft-azure-api/Services/Storage/Lib/DotNetCommon/Blob/CloudBlockBlob.cs
  56. +2 −0 microsoft-azure-api/Services/Storage/Lib/DotNetCommon/Blob/CloudPageBlob.cs
  57. +9 −1 microsoft-azure-api/Services/Storage/Lib/DotNetCommon/Blob/Protocol/BlobHttpResponseParsers.cs
  58. +4 −4 microsoft-azure-api/Services/Storage/Lib/DotNetCommon/Blob/Protocol/BlobHttpWebRequestFactory.cs
  59. +26 −10 microsoft-azure-api/Services/Storage/Lib/DotNetCommon/Core/Logger.cs
  60. +2 −0 microsoft-azure-api/Services/Storage/Lib/DotNetCommon/Core/Util/APMWithTimeout.cs
  61. +80 −5 microsoft-azure-api/Services/Storage/Lib/DotNetCommon/Queue/CloudQueue.cs
  62. +3 −3 microsoft-azure-api/Services/Storage/Lib/DotNetCommon/Queue/CloudQueueClient.cs
  63. +14 −5 microsoft-azure-api/Services/Storage/Lib/DotNetCommon/Shared/Protocol/HttpWebRequestFactory.cs
  64. +19 −8 microsoft-azure-api/Services/Storage/Lib/DotNetCommon/Table/CloudTable.cs
  65. +22 −34 microsoft-azure-api/Services/Storage/Lib/DotNetCommon/Table/CloudTableClient.cs
  66. +2 −2 microsoft-azure-api/Services/Storage/Lib/DotNetCommon/Table/DataServices/TableServiceContext.cs
  67. +18 −1 ...t-azure-api/Services/Storage/Lib/DotNetCommon/Table/Protocol/TableOperationHttpResponseParsers.cs
  68. +2 −2 microsoft-azure-api/Services/Storage/Lib/DotNetCommon/Table/TableOperation.cs
  69. +14 −3 microsoft-azure-api/Services/Storage/Lib/DotNetCommon/Table/TableQuery.cs
  70. +4 −4 microsoft-azure-api/Services/Storage/Lib/DotNetCommon/Table/TableQueryNonGeneric.cs
  71. +3 −3 microsoft-azure-api/Services/Storage/Lib/RT/Blob/CloudBlobClient.cs
  72. +4 −4 microsoft-azure-api/Services/Storage/Lib/RT/Blob/Protocol/BlobHttpRequestMessageFactory.cs
  73. +1 −1 microsoft-azure-api/Services/Storage/Lib/RT/Blob/Protocol/BlobHttpResponseParsers.cs
  74. +1 −1 microsoft-azure-api/Services/Storage/Lib/RT/Properties/AssemblyInfo.cs
  75. +11 −11 microsoft-azure-api/Services/Storage/Lib/RT/Queue/CloudQueue.cs
  76. +10 −5 microsoft-azure-api/Services/Storage/Lib/RT/Queue/CloudQueueClient.cs
  77. +1 −0 microsoft-azure-api/Services/Storage/Lib/RT/Shared/Protocol/HttpClientFactory.cs
  78. +1 −1 microsoft-azure-api/Services/Storage/Lib/RT/Shared/Protocol/HttpRequestMessageFactory.cs
  79. +1 −6 microsoft-azure-api/Services/Storage/Lib/RT/Table/CloudTableClient.cs
  80. +20 −1 microsoft-azure-api/Services/Storage/Lib/RT/Table/Protocol/TableOperationHttpResponseParsers.cs
  81. +1 −1 microsoft-azure-api/Services/Storage/Lib/RTTable/Properties/AssemblyInfo.cs
  82. +1 −1 microsoft-azure-api/Services/Storage/Lib/WP/Properties/AssemblyInfo.cs
  83. +59 −0 microsoft-azure-api/Services/Storage/Test/Unit/Common/Core/UtilityTests.cs
  84. +1 −1 microsoft-azure-api/Services/Storage/Test/Unit/Common/Readme.txt
  85. +2 −0 microsoft-azure-api/Services/Storage/Test/Unit/Common/Table/Entities/ComplexEntity.cs
  86. +8 −26 microsoft-azure-api/Services/Storage/Test/Unit/Common/TestBase.Common.cs
  87. +1 −1 microsoft-azure-api/Services/Storage/Test/Unit/DotNet40/Properties/AssemblyInfo.cs
  88. +2 −4 microsoft-azure-api/Services/Storage/Test/Unit/DotNet40/WCFBufferManagerAdapter.cs
  89. +20 −2 microsoft-azure-api/Services/Storage/Test/Unit/DotNetCommon/Blob/BlobWriteStreamTest.cs
  90. +33 −3 microsoft-azure-api/Services/Storage/Test/Unit/DotNetCommon/Core/RetryPoliciesTests.cs
  91. +16 −4 microsoft-azure-api/Services/Storage/Test/Unit/DotNetCommon/Queue/CloudQueueTest.cs
  92. +46 −0 microsoft-azure-api/Services/Storage/Test/Unit/DotNetCommon/Table/SAS/TableSasUnitTests.cs
  93. +82 −5 microsoft-azure-api/Services/Storage/Test/Unit/DotNetCommon/Table/TableOperationUnitTests.cs
  94. +2 −2 microsoft-azure-api/Services/Storage/Test/Unit/DotNetCommon/Table/TableQueryableTests.cs
  95. +0 −5 microsoft-azure-api/Services/Storage/Test/Unit/DotNetCommon/TestBase.cs
  96. +1 −9 microsoft-azure-api/Services/Storage/Test/Unit/DotNetCommon/TestHelper.cs
  97. +3 −0 microsoft-azure-api/Services/Storage/Test/Unit/FaultInjection/XStoreMangler/app.config
  98. +1 −1 microsoft-azure-api/Services/Storage/Test/Unit/RT/Package.appxmanifest
  99. +1 −1 microsoft-azure-api/Services/Storage/Test/Unit/RT/Properties/AssemblyInfo.cs
  100. +4 −4 microsoft-azure-api/Services/Storage/Test/Unit/RT/Queue/CloudQueueClientTest.cs
  101. +0 −23 microsoft-azure-api/Services/Storage/Test/Unit/RT/Queue/CloudQueueMessageTest.cs
  102. +16 −4 microsoft-azure-api/Services/Storage/Test/Unit/RT/Queue/CloudQueueTest.cs
  103. +1 −1 microsoft-azure-api/Services/Storage/Test/Unit/RT/RT.csproj
  104. BIN microsoft-azure-api/Services/Storage/Test/Unit/RT/RT_Test_TemporaryKey.pfx
  105. +46 −0 microsoft-azure-api/Services/Storage/Test/Unit/RT/Table/SAS/TableSasUnitTests.cs
  106. +46 −0 microsoft-azure-api/Services/Storage/Test/Unit/RT/Table/TableOperationUnitTests.cs
  107. +364 −0 microsoft-azure-api/Services/Storage/Test/Unit/WP/Blob/BlobAnalyticsUnitTests.cs
  108. +139 −0 microsoft-azure-api/Services/Storage/Test/Unit/WP/Blob/BlobCancellationUnitTests.cs
  109. +383 −0 microsoft-azure-api/Services/Storage/Test/Unit/WP/Blob/BlobReadStreamTest.cs
  110. +314 −0 microsoft-azure-api/Services/Storage/Test/Unit/WP/Blob/BlobStreamTests.cs
  111. +97 −0 microsoft-azure-api/Services/Storage/Test/Unit/WP/Blob/BlobTestBase.cs
  112. +562 −0 microsoft-azure-api/Services/Storage/Test/Unit/WP/Blob/BlobUploadDownloadTest.cs
  113. +680 −0 microsoft-azure-api/Services/Storage/Test/Unit/WP/Blob/BlobWriteStreamTest.cs
  114. +463 −0 microsoft-azure-api/Services/Storage/Test/Unit/WP/Blob/CloudBlobClientTest.cs
  115. +634 −0 microsoft-azure-api/Services/Storage/Test/Unit/WP/Blob/CloudBlobContainerTest.cs
  116. +491 −0 microsoft-azure-api/Services/Storage/Test/Unit/WP/Blob/CloudBlobDirectoryTest.cs
  117. +1,378 −0 microsoft-azure-api/Services/Storage/Test/Unit/WP/Blob/CloudBlockBlobTest.cs
  118. +1,205 −0 microsoft-azure-api/Services/Storage/Test/Unit/WP/Blob/CloudPageBlobTest.cs
  119. +468 −0 microsoft-azure-api/Services/Storage/Test/Unit/WP/Blob/CopyBlobTest.cs
  120. +2,926 −0 microsoft-azure-api/Services/Storage/Test/Unit/WP/Blob/LeaseTests.cs
  121. +46 −0 microsoft-azure-api/Services/Storage/Test/Unit/WP/Blob/MD5FlagsTest.cs
  122. +296 −0 microsoft-azure-api/Services/Storage/Test/Unit/WP/Blob/SASTests.cs
  123. +1 −1 microsoft-azure-api/Services/Storage/Test/Unit/WP/Properties/AssemblyInfo.cs
  124. +187 −0 microsoft-azure-api/Services/Storage/Test/Unit/WP/Queue/CloudQueueClientTest.cs
  125. +261 −0 microsoft-azure-api/Services/Storage/Test/Unit/WP/Queue/CloudQueueMessageTest.cs
  126. +343 −0 microsoft-azure-api/Services/Storage/Test/Unit/WP/Queue/CloudQueueTest.cs
  127. +359 −0 microsoft-azure-api/Services/Storage/Test/Unit/WP/Queue/QueueAnalyticsUnitTests.cs
  128. +5 −5 microsoft-azure-api/Services/Storage/Test/Unit/WP/Table/CloudTableClientTaskTest.cs
  129. +5 −5 microsoft-azure-api/Services/Storage/Test/Unit/WP/Table/TableAnalyticsUnitTaskTests.cs
  130. +4 −4 microsoft-azure-api/Services/Storage/Test/Unit/WP/Table/TableBatchOperationTaskTest.cs
  131. +5 −4 microsoft-azure-api/Services/Storage/Test/Unit/WP/Table/TableEntitySerializationTests.cs
  132. +4 −4 microsoft-azure-api/Services/Storage/Test/Unit/WP/Table/TableEscapingTaskTests.cs
  133. +4 −4 microsoft-azure-api/Services/Storage/Test/Unit/WP/Table/TableOperationUnitTaskTests.cs
  134. +5 −5 microsoft-azure-api/Services/Storage/Test/Unit/WP/Table/TableQueryGenericTaskTests.cs
  135. +5 −5 microsoft-azure-api/Services/Storage/Test/Unit/WP/Table/TableQueryTaskTests.cs
  136. +9 −40 microsoft-azure-api/Services/Storage/Test/Unit/WP/Table/TableQueryableTests.cs
  137. +47 −0 microsoft-azure-api/Services/Storage/Test/Unit/WP/TestBase.cs
  138. +113 −0 microsoft-azure-api/Services/Storage/Test/Unit/WP/TestHelper.cs
  139. +33 −37 microsoft-azure-api/Services/Storage/Test/Unit/WP/WP.csproj
  140. +7 −0 microsoft-azure-api/Services/Storage/changelog.txt
@@ -36,13 +36,19 @@
<Word>GetDefaultBufferSize</Word>
<Word>ITableEntity</Word>
<Word>EndRead</Word>
- <Word>TableQuery</Word>
- <Word>EndFlush</Word>
- <Word>EntityProperty</Word>
- <Word>ExecuteQuery</Word>
- <Word>CloudTable</Word>
- <Word>CreateQuery</Word>
- <Word>Etag</Word>
+ <Word>TableQuery</Word>
+ <Word>EndFlush</Word>
+ <Word>EntityProperty</Word>
+ <Word>ExecuteQuery</Word>
+ <Word>CloudTable</Word>
+ <Word>CreateQuery</Word>
+ <Word>TableQuery</Word>
+ <Word>EndFlush</Word>
+ <Word>EntityProperty</Word>
+ <Word>ExecuteQuery</Word>
+ <Word>CloudTable</Word>
+ <Word>CreateQuery</Word>
+ <Word>Etag</Word>
</Recognized>
<Compound>
<Term CompoundAlternate="TableQuery">Tablequery</Term>
@@ -36,19 +36,19 @@ public sealed class AccessCondition
private DateTimeOffset? ifNotModifiedSinceDateTime;
/// <summary>
- /// Gets or sets an "etag" that must match the ETag of a resource.
+ /// Gets or sets an ETag value that must match the ETag of the specified resource.
/// </summary>
- /// <value>A quoted ETag string. If <c>null</c>, no condition exists.</value>
+ /// <value>A string containing an ETag value, or <c>"*"</c> to match any ETag. If <c>null</c>, no condition exists.</value>
public string IfMatchETag
{
get;
set;
}
/// <summary>
- /// Gets or sets an ETag that must not match the ETag of a resource.
+ /// Gets or sets an ETag value that must not match the ETag of the specified resource.
/// </summary>
- /// <value>A quoted ETag string, or <c>"*"</c> to match any ETag. If null, no condition exists.</value>
+ /// <value>A string containing an ETag value, or <c>"*"</c> to match any ETag. If <c>null</c>, no condition exists.</value>
public string IfNoneMatchETag
{
get;
@@ -58,7 +58,7 @@ public string IfNoneMatchETag
/// <summary>
/// Gets or sets a time that must be before the last modification of a resource.
/// </summary>
- /// <value>A <c>DateTimeOffset</c> in UTC, or null if no condition exists.</value>
+ /// <value>A <c>DateTimeOffset</c> in UTC, or <c>null</c> if no condition exists.</value>
public DateTimeOffset? IfModifiedSinceTime
{
get
@@ -75,7 +75,7 @@ public string IfNoneMatchETag
/// <summary>
/// Gets or sets a time that must not be before the last modification of a resource.
/// </summary>
- /// <value>A <c>DateTimeOffset</c> in UTC, or null if no condition exists.</value>
+ /// <value>A <c>DateTimeOffset</c> in UTC, or <c>null</c> if no condition exists.</value>
public DateTimeOffset? IfNotModifiedSinceTime
{
get
@@ -92,7 +92,7 @@ public string IfNoneMatchETag
/// <summary>
/// Gets or sets a sequence number that the current sequence number of a page blob must be less than or equal to in order for the operation to proceed.
/// </summary>
- /// <value>A sequence number, or null if no condition exists.</value>
+ /// <value>A sequence number, or <c>null</c> if no condition exists.</value>
/// <remarks>This condition only applies to page blobs.</remarks>
public long? IfSequenceNumberLessThanOrEqual
{
@@ -103,7 +103,7 @@ public string IfNoneMatchETag
/// <summary>
/// Gets or sets a sequence number that the current sequence number of a page blob must be less than in order for the operation to proceed.
/// </summary>
- /// <value>A sequence number, or null if no condition exists.</value>
+ /// <value>A sequence number, or <c>null</c> if no condition exists.</value>
/// <remarks>This condition only applies to page blobs.</remarks>
public long? IfSequenceNumberLessThan
{
@@ -114,7 +114,7 @@ public string IfNoneMatchETag
/// <summary>
/// Gets or sets a sequence number that the current sequence number of a page blob must be equal to in order for the operation to proceed.
/// </summary>
- /// <value>A sequence number, or null if no condition exists.</value>
+ /// <value>A sequence number, or <c>null</c> if no condition exists.</value>
/// <remarks>This condition only applies to page blobs.</remarks>
public long? IfSequenceNumberEqual
{
@@ -125,7 +125,7 @@ public string IfNoneMatchETag
/// <summary>
/// Gets or sets a lease ID that must match the lease on a resource.
/// </summary>
- /// <value>A lease ID, or null if no condition exists.</value>
+ /// <value>A lease ID, or <c>null</c> if no condition exists.</value>
public string LeaseId
{
get;
@@ -106,7 +106,7 @@ public StorageCredentials()
/// Initializes a new instance of the <see cref="StorageCredentials"/> class with the specified account name and key value.
/// </summary>
/// <param name="accountName">A string that represents the name of the storage account.</param>
- /// <param name="keyValue">A string that represents the Base-64-encoded account access key.</param>
+ /// <param name="keyValue">A string that represents the Base64-encoded account access key.</param>
public StorageCredentials(string accountName, string keyValue)
: this(accountName, keyValue, null)
{
@@ -128,7 +128,7 @@ public StorageCredentials(string accountName, byte[] keyValue)
/// Initializes a new instance of the <see cref="StorageCredentials"/> class with the specified account name, key value, and key name.
/// </summary>
/// <param name="accountName">A string that represents the name of the storage account.</param>
- /// <param name="keyValue">A string that represents the Base-64-encoded account access key.</param>
+ /// <param name="keyValue">A string that represents the Base64-encoded account access key.</param>
/// <param name="keyName">A string that represents the name of the key.</param>
public StorageCredentials(string accountName, string keyValue, string keyName)
{
@@ -178,7 +178,7 @@ public StorageCredentials(string sasToken)
/// <summary>
/// Updates the key value for the credentials.
/// </summary>
- /// <param name="keyValue">The key value, as a Base-64 encoded string, to update.</param>
+ /// <param name="keyValue">The key value, as a Base64-encoded string, to update.</param>
public void UpdateKey(string keyValue)
{
this.UpdateKey(keyValue, null);
@@ -198,7 +198,7 @@ public void UpdateKey(byte[] keyValue)
/// <summary>
/// Updates the key value and key name for the credentials.
/// </summary>
- /// <param name="keyValue">The key value, as a Base-64 encoded string, to update.</param>
+ /// <param name="keyValue">The key value, as a Base64-encoded string, to update.</param>
/// <param name="keyName">The key name to update.</param>
public void UpdateKey(string keyValue, string keyName)
{
@@ -240,9 +240,9 @@ public void UpdateKey(byte[] keyValue, string keyName)
#endif
/// <summary>
- /// Updates the sas token value for the credentials.
+ /// Updates the shared access signature (SAS) token value for storage credentials created with a shared access signature.
/// </summary>
- /// <param name="sasToken">The sasToken value,as a string, to update.</param>
+ /// <param name="sasToken">A string that specifies the SAS token value to update.</param>
[SuppressMessage("Microsoft.Naming", "CA1709:IdentifiersShouldBeCasedCorrectly", MessageId = "SAS", Justification = "Back compatibility.")]
public void UpdateSASToken(string sasToken)
{
@@ -262,7 +262,7 @@ public void UpdateSASToken(string sasToken)
}
/// <summary>
- /// Returns the key for the credentials.
+ /// Returns the account key for the credentials.
/// </summary>
/// <returns>An array of bytes that contains the key.</returns>
public byte[] ExportKey()
@@ -288,7 +288,7 @@ public Uri TransformUri(Uri resourceUri)
}
/// <summary>
- /// Exports the value of the access key to a Base64-encoded string.
+ /// Exports the value of the account access key to a Base64-encoded string.
/// </summary>
/// <returns>The account access key.</returns>
public string ExportBase64EncodedKey()
@@ -33,7 +33,7 @@ public enum BlobContainerPublicAccessType
Container,
/// <summary>
- /// Blob-level public access. Anonymous clients can read only blob data within this container.
+ /// Blob-level public access. Anonymous clients can read blob data within this container, but not container data.
/// </summary>
Blob
}
@@ -38,7 +38,7 @@ public BlobProperties()
/// Initializes a new instance of the <see cref="BlobProperties"/> class based on an existing instance.
/// </summary>
/// <param name="other">The set of properties to clone.</param>
- /// <remarks>Lease related properties will not be cloned, because a lease associated with the base blob is not copied to the snapshot.</remarks>
+ /// <remarks>Lease-related properties will not be cloned, because a lease associated with the base blob is not copied to the snapshot.</remarks>
public BlobProperties(BlobProperties other)
{
CommonUtility.AssertNotNull("other", other);
@@ -23,7 +23,7 @@ namespace Microsoft.WindowsAzure.Storage.Blob
using System;
/// <summary>
- /// Represents a set of timeout and retry policy options that may be specified for a blob operation request.
+ /// Represents a set of timeout and retry policy options that may be specified for a request against the Blob service.
/// </summary>
public sealed class BlobRequestOptions : IRequestOptions
{
@@ -66,22 +66,21 @@ internal static BlobRequestOptions ApplyDefaults(BlobRequestOptions options, Blo
modifiedOptions.OperationExpiryTime = DateTime.Now + modifiedOptions.MaximumExecutionTime.Value;
}
- modifiedOptions.DisableContentMD5Validation = modifiedOptions.DisableContentMD5Validation ?? false;
-
- modifiedOptions.StoreBlobContentMD5 =
#if WINDOWS_PHONE
- false;
+ modifiedOptions.DisableContentMD5Validation = true;
+ modifiedOptions.StoreBlobContentMD5 = false;
+ modifiedOptions.UseTransactionalMD5 = false;
#else
- modifiedOptions.StoreBlobContentMD5 ?? (blobType == BlobType.BlockBlob);
-#endif
-
+ modifiedOptions.DisableContentMD5Validation = modifiedOptions.DisableContentMD5Validation ?? false;
+ modifiedOptions.StoreBlobContentMD5 = modifiedOptions.StoreBlobContentMD5 ?? (blobType == BlobType.BlockBlob);
modifiedOptions.UseTransactionalMD5 = modifiedOptions.UseTransactionalMD5 ?? false;
+#endif
return modifiedOptions;
}
/// <summary>
- /// Gets or sets the absolute Expiry time across all potential retries etc.
+ /// Gets or sets the absolute expiry time across all potential retries for the request.
/// </summary>
internal DateTime? OperationExpiryTime { get; set; }
@@ -98,9 +97,9 @@ internal static BlobRequestOptions ApplyDefaults(BlobRequestOptions options, Blo
public TimeSpan? ServerTimeout { get; set; }
/// <summary>
- /// Gets or sets the maximum execution time across all potential retries etc.
+ /// Gets or sets the maximum execution time across all potential retries for the request.
/// </summary>
- /// <value>The maximum execution time.</value>
+ /// <value>A <see cref="TimeSpan"/> representing the maximum execution time for retries for the request.</value>
public TimeSpan? MaximumExecutionTime { get; set; }
/// <summary>
@@ -176,7 +175,7 @@ internal static BlobRequestOptions ApplyDefaults(BlobRequestOptions options, Blo
set
{
#if WINDOWS_PHONE
- if (value.HasValue && value.Value)
+ if (value.HasValue && !value.Value)
{
throw new NotSupportedException(SR.WindowsPhoneDoesNotSupportMD5);
}
@@ -20,7 +20,7 @@ namespace Microsoft.WindowsAzure.Storage.Blob
using System.Collections.Generic;
/// <summary>
- /// Represents a segment of <see cref="IListBlobItem"/> results and contains continuation and pagination information.
+ /// Represents a segment of <see cref="IListBlobItem"/> results, with continuation information for pagination scenarios.
/// </summary>
public sealed class BlobResultSegment
{
@@ -37,7 +37,7 @@ internal BlobResultSegment(IEnumerable<IListBlobItem> blobs, BlobContinuationTok
public IEnumerable<IListBlobItem> Results { get; private set; }
/// <summary>
- /// Gets the continuation token used to retrieve the next segment of <see cref="IListBlobItem"/> results. Returns null if there are no more results.
+ /// Gets the continuation token used to retrieve the next segment of <see cref="IListBlobItem"/> results. Returns <c>null</c> if there are no more results.
/// </summary>
/// <value>The continuation token.</value>
public BlobContinuationToken ContinuationToken { get; private set; }
@@ -28,9 +28,10 @@ namespace Microsoft.WindowsAzure.Storage.Blob
using System.Globalization;
/// <summary>
- /// Provides a client-side logical representation of the Windows Azure Blob Service. This client is used to configure and execute requests against the Blob Service.
+ /// Provides a client-side logical representation of the Windows Azure Blob service. This client is used to configure and execute requests against the Blob service.
/// </summary>
- /// <remarks>The service client encapsulates the base URI for the Blob service. If the service client will be used for authenticated access, it also encapsulates the credentials for accessing the storage account.</remarks>
+ /// <remarks>The service client encapsulates the base URI for the Blob service. If the service client will be used for authenticated access, it also encapsulates
+ /// the credentials for accessing the storage account.</remarks>
public sealed partial class CloudBlobClient
{
/// <summary>
@@ -131,7 +132,8 @@ internal CloudBlobClient(bool? usePathStyleUris, Uri baseUri, StorageCredentials
}
/// <summary>
- /// The IBufferManager to use for associated objects
+ /// Gets or sets a buffer manager that implements the <see cref="IBufferManager"/> interface,
+ /// specifying a buffer pool for use with operations against the Blob service client.
/// </summary>
public IBufferManager BufferManager { get; set; }
@@ -154,7 +156,7 @@ internal CloudBlobClient(bool? usePathStyleUris, Uri baseUri, StorageCredentials
public IRetryPolicy RetryPolicy { get; set; }
/// <summary>
- /// Gets or sets the default server and client timeout for requests.
+ /// Gets or sets the default server and client timeout for requests made via the Blob service client.
/// </summary>
/// <value>The server and client timeout interval.</value>
public TimeSpan? ServerTimeout
@@ -260,7 +262,7 @@ public int ParallelOperationThreadCount
internal bool UsePathStyleUris { get; private set; }
/// <summary>
- /// Returns a reference to a <see cref="CloudBlobContainer"/> object.
+ /// Returns a reference to the root container for this service client.
/// </summary>
/// <returns>A reference to the root container.</returns>
[SuppressMessage("Microsoft.Design", "CA1024:UsePropertiesWhereAppropriate", Justification = "Reviewed")]
@@ -150,7 +150,8 @@ private string GetSharedAccessCanonicalName()
/// Returns a shared access signature for the container.
/// </summary>
/// <param name="policy">The access policy for the shared access signature.</param>
- /// <returns>A shared access signature.</returns>
+ /// <returns>A shared access signature, as a URI query string.</returns>
+ /// <remarks>The query string returned includes the leading question mark.</remarks>
public string GetSharedAccessSignature(SharedAccessBlobPolicy policy)
{
return this.GetSharedAccessSignature(policy, null /* groupPolicyIdentifier */);
@@ -161,7 +162,8 @@ public string GetSharedAccessSignature(SharedAccessBlobPolicy policy)
/// </summary>
/// <param name="policy">The access policy for the shared access signature.</param>
/// <param name="groupPolicyIdentifier">A container-level access policy.</param>
- /// <returns>A shared access signature.</returns>
+ /// <returns>A shared access signature, as a URI query string.</returns>
+ /// <remarks>The query string returned includes the leading question mark.</remarks>
public string GetSharedAccessSignature(SharedAccessBlobPolicy policy, string groupPolicyIdentifier)
{
if (!this.ServiceClient.Credentials.IsSharedKey)
Oops, something went wrong.

0 comments on commit de9e558

Please sign in to comment.