CreateBlock Method

Creates a new block to be committed as part of a block blob.

Syntax

[VB.NET]
Public Sub CreateBlock(ByVal blobName As String, ByVal blockId As String)

[C#]
public void CreateBlock(string blobName, string blockId);

Remarks

This method will create a new block to be committed as part of the blob specified by blobName. By default, blockId will be Base64 encoded by the component. Thus you will not need to encode the blockId values yourself. EncodeBlockId can be set to false, to turn off the automatic encoding (thus all encoding/decoding must be handled manually). Prior to encoding, the blockId must be less than or equal to 64 bytes in size. Note for a given blob, all block IDs must be the same length.

After a block has been created, it will not be committed as part of the blob content until PutBlockList is called.

Note the maximum number of uncommitted blocks that may be associated with a blob is 100,000, and the maximum size of the uncommitted block list is 400 GB.

Any uncommitted blocks will be garbage collected if there are no successful calls to CreateBlock or PutBlockList on the blob within a week following the last successful CreateBlock call. If CreateBlob is called on the blob, any uncommitted blocks will be garbage collected.

If the blob has an active lease, LeaseId must be specified prior to calling CreateBlock.