CloudBlockBlob.PutBlockAsync Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Overloads
PutBlockAsync(String, Uri, Nullable<Int64>, Nullable<Int64>, String, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)
Initiates an asynchronous operation to upload a single block.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task PutBlockAsync (string blockId, Uri sourceUri, long? offset, long? count, string contentMD5, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext, System.Threading.CancellationToken cancellationToken);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member PutBlockAsync : string * Uri * Nullable<int64> * Nullable<int64> * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.PutBlockAsync : string * Uri * Nullable<int64> * Nullable<int64> * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overridable Function PutBlockAsync (blockId As String, sourceUri As Uri, offset As Nullable(Of Long), count As Nullable(Of Long), contentMD5 As String, accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As Task
Parameters
- blockId
- String
A Base64-encoded string that identifies the block.
The number of bytes to return, or null
to return all bytes through the end of the blob.
- contentMD5
- String
An optional hash value used to ensure transactional integrity. May be null
or an empty string.
- accessCondition
- AccessCondition
An AccessCondition object that represents the condition that must be met in order for the request to proceed. If null
, no condition is used.
- options
- BlobRequestOptions
A BlobRequestOptions object that specifies additional options for the request.
- operationContext
- OperationContext
An OperationContext object that represents the context for the current operation.
- cancellationToken
- CancellationToken
A CancellationToken to observe while waiting for a task to complete.
Returns
A Task object that represents the asynchronous operation.
- Attributes
Remarks
Clients may send the Content-MD5 header for a given Put Block operation as a means to ensure transactional integrity over the wire. The contentMD5
parameter permits clients who already have access to a pre-computed MD5 value for a given byte range to provide it.
Applies to
PutBlockAsync(String, Uri, Nullable<Int64>, Nullable<Int64>, Checksum, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)
Initiates an asynchronous operation to upload a single block.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task PutBlockAsync (string blockId, Uri sourceUri, long? offset, long? count, Microsoft.Azure.Storage.Shared.Protocol.Checksum contentChecksum, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext, System.Threading.CancellationToken cancellationToken);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member PutBlockAsync : string * Uri * Nullable<int64> * Nullable<int64> * Microsoft.Azure.Storage.Shared.Protocol.Checksum * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.PutBlockAsync : string * Uri * Nullable<int64> * Nullable<int64> * Microsoft.Azure.Storage.Shared.Protocol.Checksum * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overridable Function PutBlockAsync (blockId As String, sourceUri As Uri, offset As Nullable(Of Long), count As Nullable(Of Long), contentChecksum As Checksum, accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As Task
Parameters
- blockId
- String
A Base64-encoded string that identifies the block.
The number of bytes to return, or null
to return all bytes through the end of the blob.
- contentChecksum
- Checksum
An optional hash value used to ensure transactional integrity. May be null
.
- accessCondition
- AccessCondition
An AccessCondition object that represents the condition that must be met in order for the request to proceed. If null
, no condition is used.
- options
- BlobRequestOptions
A BlobRequestOptions object that specifies additional options for the request.
- operationContext
- OperationContext
An OperationContext object that represents the context for the current operation.
- cancellationToken
- CancellationToken
A CancellationToken to observe while waiting for a task to complete.
Returns
A Task object that represents the asynchronous operation.
- Attributes
Applies to
PutBlockAsync(String, Stream, String, AccessCondition, BlobRequestOptions, OperationContext, IProgress<StorageProgress>, CancellationToken)
Initiates an asynchronous operation to upload a single block.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task PutBlockAsync (string blockId, System.IO.Stream blockData, string contentMD5, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext, IProgress<Microsoft.Azure.Storage.Core.Util.StorageProgress> progressHandler, System.Threading.CancellationToken cancellationToken);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member PutBlockAsync : string * System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * IProgress<Microsoft.Azure.Storage.Core.Util.StorageProgress> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.PutBlockAsync : string * System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * IProgress<Microsoft.Azure.Storage.Core.Util.StorageProgress> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overridable Function PutBlockAsync (blockId As String, blockData As Stream, contentMD5 As String, accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, progressHandler As IProgress(Of StorageProgress), cancellationToken As CancellationToken) As Task
Parameters
- blockId
- String
A Base64-encoded string that identifies the block.
- contentMD5
- String
An optional hash value used to ensure transactional integrity. May be null
or an empty string.
- accessCondition
- AccessCondition
An AccessCondition object that represents the condition that must be met in order for the request to proceed. If null
, no condition is used.
- options
- BlobRequestOptions
A BlobRequestOptions object that specifies additional options for the request.
- operationContext
- OperationContext
An OperationContext object that represents the context for the current operation.
- progressHandler
- IProgress<StorageProgress>
A IProgress<T> object to handle StorageProgress messages.
- cancellationToken
- CancellationToken
A CancellationToken to observe while waiting for a task to complete.
Returns
A Task object that represents the asynchronous operation.
- Attributes
Remarks
Clients may send the Content-MD5 header for a given Put Block operation as a means to ensure transactional integrity over the wire. The contentMD5
parameter permits clients who already have access to a pre-computed MD5 value for a given byte range to provide it. If the BlobRequestOptions.UseTransactionalMd5 property is set to true
and the contentMD5
parameter is set to null
, then the client library will calculate the MD5 value internally.
Applies to
PutBlockAsync(String, Stream, Checksum, AccessCondition, BlobRequestOptions, OperationContext, IProgress<StorageProgress>, CancellationToken)
Initiates an asynchronous operation to upload a single block.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task PutBlockAsync (string blockId, System.IO.Stream blockData, Microsoft.Azure.Storage.Shared.Protocol.Checksum contentChecksum, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext, IProgress<Microsoft.Azure.Storage.Core.Util.StorageProgress> progressHandler, System.Threading.CancellationToken cancellationToken);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member PutBlockAsync : string * System.IO.Stream * Microsoft.Azure.Storage.Shared.Protocol.Checksum * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * IProgress<Microsoft.Azure.Storage.Core.Util.StorageProgress> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.PutBlockAsync : string * System.IO.Stream * Microsoft.Azure.Storage.Shared.Protocol.Checksum * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * IProgress<Microsoft.Azure.Storage.Core.Util.StorageProgress> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overridable Function PutBlockAsync (blockId As String, blockData As Stream, contentChecksum As Checksum, accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, progressHandler As IProgress(Of StorageProgress), cancellationToken As CancellationToken) As Task
Parameters
- blockId
- String
A Base64-encoded string that identifies the block.
- contentChecksum
- Checksum
An optional hash value used to ensure transactional integrity. May be null
.
- accessCondition
- AccessCondition
An AccessCondition object that represents the condition that must be met in order for the request to proceed. If null
, no condition is used.
- options
- BlobRequestOptions
A BlobRequestOptions object that specifies additional options for the request.
- operationContext
- OperationContext
An OperationContext object that represents the context for the current operation.
- progressHandler
- IProgress<StorageProgress>
A IProgress<T> object to handle StorageProgress messages.
- cancellationToken
- CancellationToken
A CancellationToken to observe while waiting for a task to complete.
Returns
A Task object that represents the asynchronous operation.
- Attributes
Applies to
PutBlockAsync(String, Stream, String, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)
Initiates an asynchronous operation to upload a single block.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task PutBlockAsync (string blockId, System.IO.Stream blockData, string contentMD5, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext, System.Threading.CancellationToken cancellationToken);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member PutBlockAsync : string * System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.PutBlockAsync : string * System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overridable Function PutBlockAsync (blockId As String, blockData As Stream, contentMD5 As String, accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As Task
Parameters
- blockId
- String
A Base64-encoded string that identifies the block.
- contentMD5
- String
An optional hash value used to ensure transactional integrity. May be null
or an empty string.
- accessCondition
- AccessCondition
An AccessCondition object that represents the condition that must be met in order for the request to proceed. If null
, no condition is used.
- options
- BlobRequestOptions
A BlobRequestOptions object that specifies additional options for the request.
- operationContext
- OperationContext
An OperationContext object that represents the context for the current operation.
- cancellationToken
- CancellationToken
A CancellationToken to observe while waiting for a task to complete.
Returns
A Task object that represents the asynchronous operation.
- Attributes
Remarks
Clients may send the Content-MD5 header for a given Put Block operation as a means to ensure transactional integrity over the wire. The contentMD5
parameter permits clients who already have access to a pre-computed MD5 value for a given byte range to provide it. If the BlobRequestOptions.UseTransactionalMd5 property is set to true
and the contentMD5
parameter is set to null
, then the client library will calculate the MD5 value internally.
Applies to
PutBlockAsync(String, Uri, Nullable<Int64>, Nullable<Int64>, String, CancellationToken)
Initiates an asynchronous operation to upload a single block.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task PutBlockAsync (string blockId, Uri sourceUri, long? offset, long? count, string contentMD5, System.Threading.CancellationToken cancellationToken);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member PutBlockAsync : string * Uri * Nullable<int64> * Nullable<int64> * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.PutBlockAsync : string * Uri * Nullable<int64> * Nullable<int64> * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overridable Function PutBlockAsync (blockId As String, sourceUri As Uri, offset As Nullable(Of Long), count As Nullable(Of Long), contentMD5 As String, cancellationToken As CancellationToken) As Task
Parameters
- blockId
- String
A Base64-encoded string that identifies the block.
The number of bytes to return, or null
to return all bytes through the end of the blob.
- contentMD5
- String
An optional hash value used to ensure transactional integrity. May be null
or an empty string.
- cancellationToken
- CancellationToken
A CancellationToken to observe while waiting for a task to complete.
Returns
A Task object that represents the asynchronous operation.
- Attributes
Remarks
Clients may send the Content-MD5 header for a given Put Block operation as a means to ensure transactional integrity over the wire. The contentMD5
parameter permits clients who already have access to a pre-computed MD5 value for a given byte range to provide it.
Applies to
PutBlockAsync(String, Uri, Nullable<Int64>, Nullable<Int64>, Checksum, CancellationToken)
Initiates an asynchronous operation to upload a single block.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task PutBlockAsync (string blockId, Uri sourceUri, long? offset, long? count, Microsoft.Azure.Storage.Shared.Protocol.Checksum contentChecksum, System.Threading.CancellationToken cancellationToken);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member PutBlockAsync : string * Uri * Nullable<int64> * Nullable<int64> * Microsoft.Azure.Storage.Shared.Protocol.Checksum * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.PutBlockAsync : string * Uri * Nullable<int64> * Nullable<int64> * Microsoft.Azure.Storage.Shared.Protocol.Checksum * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overridable Function PutBlockAsync (blockId As String, sourceUri As Uri, offset As Nullable(Of Long), count As Nullable(Of Long), contentChecksum As Checksum, cancellationToken As CancellationToken) As Task
Parameters
- blockId
- String
A Base64-encoded string that identifies the block.
The number of bytes to return, or null
to return all bytes through the end of the blob.
- contentChecksum
- Checksum
An optional hash value used to ensure transactional integrity. May be null
.
- cancellationToken
- CancellationToken
A CancellationToken to observe while waiting for a task to complete.
Returns
A Task object that represents the asynchronous operation.
- Attributes
Applies to
PutBlockAsync(String, Uri, Nullable<Int64>, Nullable<Int64>, String, AccessCondition, BlobRequestOptions, OperationContext)
Initiates an asynchronous operation to upload a single block.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task PutBlockAsync (string blockId, Uri sourceUri, long? offset, long? count, string contentMD5, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member PutBlockAsync : string * Uri * Nullable<int64> * Nullable<int64> * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.Task
override this.PutBlockAsync : string * Uri * Nullable<int64> * Nullable<int64> * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.Task
Public Overridable Function PutBlockAsync (blockId As String, sourceUri As Uri, offset As Nullable(Of Long), count As Nullable(Of Long), contentMD5 As String, accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext) As Task
Parameters
- blockId
- String
A Base64-encoded string that identifies the block.
The number of bytes to return, or null
to return all bytes through the end of the blob.
- contentMD5
- String
An optional hash value used to ensure transactional integrity. May be null
or an empty string.
- accessCondition
- AccessCondition
An AccessCondition object that represents the condition that must be met in order for the request to proceed. If null
, no condition is used.
- options
- BlobRequestOptions
A BlobRequestOptions object that specifies additional options for the request.
- operationContext
- OperationContext
An OperationContext object that represents the context for the current operation.
Returns
A Task object that represents the asynchronous operation.
- Attributes
Remarks
Clients may send the Content-MD5 header for a given Put Block operation as a means to ensure transactional integrity over the wire. The contentMD5
parameter permits clients who already have access to a pre-computed MD5 value for a given byte range to provide it.
Applies to
PutBlockAsync(String, Stream, Checksum, AccessCondition, BlobRequestOptions, OperationContext)
Initiates an asynchronous operation to upload a single block.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task PutBlockAsync (string blockId, System.IO.Stream blockData, Microsoft.Azure.Storage.Shared.Protocol.Checksum contentChecksum, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member PutBlockAsync : string * System.IO.Stream * Microsoft.Azure.Storage.Shared.Protocol.Checksum * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.Task
override this.PutBlockAsync : string * System.IO.Stream * Microsoft.Azure.Storage.Shared.Protocol.Checksum * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.Task
Public Overridable Function PutBlockAsync (blockId As String, blockData As Stream, contentChecksum As Checksum, accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext) As Task
Parameters
- blockId
- String
A Base64-encoded string that identifies the block.
- contentChecksum
- Checksum
An optional hash value used to ensure transactional integrity. May be null
.
- accessCondition
- AccessCondition
An AccessCondition object that represents the condition that must be met in order for the request to proceed. If null
, no condition is used.
- options
- BlobRequestOptions
A BlobRequestOptions object that specifies additional options for the request.
- operationContext
- OperationContext
An OperationContext object that represents the context for the current operation.
Returns
A Task object that represents the asynchronous operation.
- Attributes
Applies to
PutBlockAsync(String, Stream, String, AccessCondition, BlobRequestOptions, OperationContext)
Initiates an asynchronous operation to upload a single block.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task PutBlockAsync (string blockId, System.IO.Stream blockData, string contentMD5, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member PutBlockAsync : string * System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.Task
override this.PutBlockAsync : string * System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.Task
Public Overridable Function PutBlockAsync (blockId As String, blockData As Stream, contentMD5 As String, accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext) As Task
Parameters
- blockId
- String
A Base64-encoded string that identifies the block.
- contentMD5
- String
An optional hash value used to ensure transactional integrity. May be null
or an empty string.
- accessCondition
- AccessCondition
An AccessCondition object that represents the condition that must be met in order for the request to proceed. If null
, no condition is used.
- options
- BlobRequestOptions
A BlobRequestOptions object that specifies additional options for the request.
- operationContext
- OperationContext
An OperationContext object that represents the context for the current operation.
Returns
A Task object that represents the asynchronous operation.
- Attributes
Remarks
Clients may send the Content-MD5 header for a given Put Block operation as a means to ensure transactional integrity over the wire. The contentMD5
parameter permits clients who already have access to a pre-computed MD5 value for a given byte range to provide it. If the BlobRequestOptions.UseTransactionalMd5 property is set to true
and the contentMD5
parameter is set to null
, then the client library will calculate the MD5 value internally.
Applies to
PutBlockAsync(String, Stream, Checksum)
Initiates an asynchronous operation to upload a single block.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task PutBlockAsync (string blockId, System.IO.Stream blockData, Microsoft.Azure.Storage.Shared.Protocol.Checksum contentChecksum = default);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member PutBlockAsync : string * System.IO.Stream * Microsoft.Azure.Storage.Shared.Protocol.Checksum -> System.Threading.Tasks.Task
override this.PutBlockAsync : string * System.IO.Stream * Microsoft.Azure.Storage.Shared.Protocol.Checksum -> System.Threading.Tasks.Task
Public Overridable Function PutBlockAsync (blockId As String, blockData As Stream, Optional contentChecksum As Checksum = Nothing) As Task
Parameters
- blockId
- String
A Base64-encoded string that identifies the block.
- contentChecksum
- Checksum
An optional hash value used to ensure transactional integrity. May be null
.
Returns
A Task object that represents the asynchronous operation.
- Attributes
Applies to
PutBlockAsync(String, Stream, String)
Initiates an asynchronous operation to upload a single block.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task PutBlockAsync (string blockId, System.IO.Stream blockData, string contentMD5);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member PutBlockAsync : string * System.IO.Stream * string -> System.Threading.Tasks.Task
override this.PutBlockAsync : string * System.IO.Stream * string -> System.Threading.Tasks.Task
Public Overridable Function PutBlockAsync (blockId As String, blockData As Stream, contentMD5 As String) As Task
Parameters
- blockId
- String
A Base64-encoded string that identifies the block.
- contentMD5
- String
An optional hash value used to ensure transactional integrity. May be null
or an empty string.
Returns
A Task object that represents the asynchronous operation.
- Attributes
Remarks
Clients may send the Content-MD5 header for a given Put Block operation as a means to ensure transactional integrity over the wire. The contentMD5
parameter permits clients who already have access to a pre-computed MD5 value for a given byte range to provide it. If the BlobRequestOptions.UseTransactionalMd5 property is set to true
and the contentMD5
parameter is set to null
, then the client library will calculate the MD5 value internally.
Applies to
PutBlockAsync(String, Uri, Nullable<Int64>, Nullable<Int64>, Checksum, AccessCondition, BlobRequestOptions, OperationContext)
Initiates an asynchronous operation to upload a single block.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task PutBlockAsync (string blockId, Uri sourceUri, long? offset, long? count, Microsoft.Azure.Storage.Shared.Protocol.Checksum contentChecksum, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member PutBlockAsync : string * Uri * Nullable<int64> * Nullable<int64> * Microsoft.Azure.Storage.Shared.Protocol.Checksum * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.Task
override this.PutBlockAsync : string * Uri * Nullable<int64> * Nullable<int64> * Microsoft.Azure.Storage.Shared.Protocol.Checksum * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.Task
Public Overridable Function PutBlockAsync (blockId As String, sourceUri As Uri, offset As Nullable(Of Long), count As Nullable(Of Long), contentChecksum As Checksum, accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext) As Task
Parameters
- blockId
- String
A Base64-encoded string that identifies the block.
The number of bytes to return, or null
to return all bytes through the end of the blob.
- contentChecksum
- Checksum
An optional hash value used to ensure transactional integrity. May be null
.
- accessCondition
- AccessCondition
An AccessCondition object that represents the condition that must be met in order for the request to proceed. If null
, no condition is used.
- options
- BlobRequestOptions
A BlobRequestOptions object that specifies additional options for the request.
- operationContext
- OperationContext
An OperationContext object that represents the context for the current operation.
Returns
A Task object that represents the asynchronous operation.
- Attributes
Applies to
PutBlockAsync(String, Stream, String, CancellationToken)
Initiates an asynchronous operation to upload a single block.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task PutBlockAsync (string blockId, System.IO.Stream blockData, string contentMD5, System.Threading.CancellationToken cancellationToken);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member PutBlockAsync : string * System.IO.Stream * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.PutBlockAsync : string * System.IO.Stream * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overridable Function PutBlockAsync (blockId As String, blockData As Stream, contentMD5 As String, cancellationToken As CancellationToken) As Task
Parameters
- blockId
- String
A Base64-encoded string that identifies the block.
- contentMD5
- String
An optional hash value used to ensure transactional integrity. May be null
or an empty string.
- cancellationToken
- CancellationToken
A CancellationToken to observe while waiting for a task to complete.
Returns
A Task object that represents the asynchronous operation.
- Attributes
Remarks
Clients may send the Content-MD5 header for a given Put Block operation as a means to ensure transactional integrity over the wire. The contentMD5
parameter permits clients who already have access to a pre-computed MD5 value for a given byte range to provide it. If the BlobRequestOptions.UseTransactionalMd5 property is set to true
and the contentMD5
parameter is set to null
, then the client library will calculate the MD5 value internally.
Applies to
PutBlockAsync(String, Uri, Nullable<Int64>, Nullable<Int64>, Checksum)
Initiates an asynchronous operation to upload a single block.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task PutBlockAsync (string blockId, Uri sourceUri, long? offset, long? count, Microsoft.Azure.Storage.Shared.Protocol.Checksum contentChecksum = default);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member PutBlockAsync : string * Uri * Nullable<int64> * Nullable<int64> * Microsoft.Azure.Storage.Shared.Protocol.Checksum -> System.Threading.Tasks.Task
override this.PutBlockAsync : string * Uri * Nullable<int64> * Nullable<int64> * Microsoft.Azure.Storage.Shared.Protocol.Checksum -> System.Threading.Tasks.Task
Public Overridable Function PutBlockAsync (blockId As String, sourceUri As Uri, offset As Nullable(Of Long), count As Nullable(Of Long), Optional contentChecksum As Checksum = Nothing) As Task
Parameters
- blockId
- String
A Base64-encoded string that identifies the block.
The number of bytes to return, or null
to return all bytes through the end of the blob.
- contentChecksum
- Checksum
An optional hash value used to ensure transactional integrity. May be null
.
Returns
- Attributes
Applies to
PutBlockAsync(String, Uri, Nullable<Int64>, Nullable<Int64>, String)
Initiates an asynchronous operation to upload a single block.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task PutBlockAsync (string blockId, Uri sourceUri, long? offset, long? count, string contentMD5);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member PutBlockAsync : string * Uri * Nullable<int64> * Nullable<int64> * string -> System.Threading.Tasks.Task
override this.PutBlockAsync : string * Uri * Nullable<int64> * Nullable<int64> * string -> System.Threading.Tasks.Task
Public Overridable Function PutBlockAsync (blockId As String, sourceUri As Uri, offset As Nullable(Of Long), count As Nullable(Of Long), contentMD5 As String) As Task
Parameters
- blockId
- String
A Base64-encoded string that identifies the block.
The number of bytes to return, or null
to return all bytes through the end of the blob.
- contentMD5
- String
An optional hash value used to ensure transactional integrity. May be null
or an empty string.
Returns
A Task object that represents the asynchronous operation.
- Attributes
Remarks
Clients may send the Content-MD5 header for a given Put Block operation as a means to ensure transactional integrity over the wire. The contentMD5
parameter permits clients who already have access to a pre-computed MD5 value for a given byte range to provide it.
Applies to
Azure SDK for .NET