エクスポート (0) 印刷
すべて展開
このトピックはまだ評価されていません - このトピックを評価する

CloudBlockBlob.PutBlock メソッド

単一のブロックをアップロードします。

名前空間: Microsoft.WindowsAzure.StorageClient
アセンブリ: Microsoft.WindowsAzure.StorageClient (Microsoft.WindowsAzure.StorageClient 内)
'使用
Dim instance As CloudBlockBlob
Dim blockId As String
Dim blockData As Stream
Dim contentMD5 As String
Dim options As BlobRequestOptions

instance.PutBlock(blockId, blockData, contentMD5, options)
public void PutBlock (
	string blockId,
	Stream blockData,
	string contentMD5,
	BlobRequestOptions options
)
public void PutBlock (
	String blockId, 
	Stream blockData, 
	String contentMD5, 
	BlobRequestOptions options
)
public function PutBlock (
	blockId : String, 
	blockData : Stream, 
	contentMD5 : String, 
	options : BlobRequestOptions
)

パラメーター

blockId

ブロックを示す Base64 エンコード形式のブロック ID。

blockData

ブロックのデータを提供するストリーム。

contentMD5

ブロックの整合性を検証するために使用されるハッシュ値。 null または空の文字列でもかまいません。

options

要求に対する追加オプションを指定するオブジェクト。

PutBlock メソッドは、今後含めるブロックをブロック BLOB にアップロードします。 ブロックの最大サイズは 4 MB です。

一連のブロックのアップロードが完了した後、PutBlockList メソッドを呼び出して、この一連のブロックからサーバー上の BLOB を作成または更新できます。 各ブロックは、BLOB 内で一意のブロック ID によって識別されます。 ブロック ID のスコープは特定の BLOB に限定されているため、異なる BLOB に同じ ID のブロックが存在する場合があります。

存在しない BLOB に対して PutBlock を呼び出した場合は、コンテンツの長さが 0 の新しいブロック BLOB が作成されます。UncommittedBlobs オプションを指定した場合は、BLOB 一覧作成操作によってこの BLOB が列挙されます。 新しい BLOB のブロック一覧をコミットするまで、アップロードしたブロックはコミットされません。 この方法で作成した BLOB は 1 週間サーバーに保持されます。この期間にブロックを追加またはコミットしなかった BLOB はガベージ コレクションされます。

現在サポートされているブロック BLOB の最大サイズは、200 GB またはブロック 50,000 個分です。 BLOB が一定期間に保持できるコミット前のブロックの最大数は 100,000 個です。コミット前のブロックのサイズは合計で 400 GB を超えることはできません。

正常にアップロードされたブロックは、PutBlockList の呼び出しによってコミットされるまで、BLOB の一部にはなりません。 ブロック一覧をコミットして新しい BLOB を作成するか、または既存の BLOB を更新するまで、BLOB のコンテンツを返す操作には、コミット前のブロックのコンテンツは含まれません。

コミット前のブロックと同じブロック ID を持つ別のブロックをアップロードすると、次に PutBlockList の呼び出しが成功したときには、その ID で最後にアップロードしたブロックがコミットされます。

PutBlockList を呼び出すと、ブロック一覧で指定されているすべてのコミット前ブロックが、新しい BLOB の一部としてコミットされます。 BLOB のブロック一覧に指定されていないコミット前のブロックはガベージ コレクションされ、BLOB サービスから削除されます。 ブロックのアップロードが最後に成功してから 1 週間以内にブロックをコミットしない場合、コミット前のブロックもガベージ コレクションされます。 その BLOB に対して別の書き込み操作を実行すると、コミット前のすべてのブロックもガベージ コレクションされます。

特定の BLOB については、すべてのブロック ID が同じ長さである必要がありますが、ブロックのコンテンツはサイズが異なっていてもかまいません。 特定の BLOB のすべてのブロック ID の長さは同じである必要があります。 アップロードされたブロックと既存のコミット前ブロックでブロック ID の長さが異なる場合は、エラー コード InvalidBlockId で例外がスローされます。

PutBlock を呼び出しても、既存の BLOB の最終更新時刻は更新されません。


この型の public static (Visual Basic では Shared) メンバーは、スレッド セーフです。インスタンス メンバーの場合は、スレッド セーフであるとは限りません。

開発プラットフォーム

Windows XP Home Edition, Windows XP Professional, Windows Server 2003、Windows Server 2008、および Windows 2000

対象プラットフォーム

この情報は役に立ちましたか。
(残り 1500 文字)
フィードバックをいただき、ありがとうございました

コミュニティの追加

表示:
© 2014 Microsoft. All rights reserved.