CloudPageBlob.OpenWrite メソッド

定義

名前空間:

Microsoft.Azure.Storage.Blob

アセンブリ:

Microsoft.Azure.Storage.Blob.dll

パッケージ:

Microsoft.Azure.Storage.Blob v11.2.3

BLOB に書き込むためのストリームを開きます。 BLOB が既に存在する場合は、BLOB 内の既存のデータが上書きされる可能性があります。

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual Microsoft.Azure.Storage.Blob.CloudBlobStream OpenWrite (long? size, Microsoft.Azure.Storage.AccessCondition accessCondition = default, Microsoft.Azure.Storage.Blob.BlobRequestOptions options = default, Microsoft.Azure.Storage.OperationContext operationContext = default);

[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member OpenWrite : Nullable<int64> * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> Microsoft.Azure.Storage.Blob.CloudBlobStream
override this.OpenWrite : Nullable<int64> * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> Microsoft.Azure.Storage.Blob.CloudBlobStream

Public Overridable Function OpenWrite (size As Nullable(Of Long), Optional accessCondition As AccessCondition = Nothing, Optional options As BlobRequestOptions = Nothing, Optional operationContext As OperationContext = Nothing) As CloudBlobStream

パラメーター

size

Nullable<Int64>

ページ BLOB のサイズ (バイト単位) です。 サイズとして、512 の倍数を指定する必要があります。 の場合 nullは、ページ BLOB が既に存在している必要があります。

accessCondition

AccessCondition

要求を実行するために満たす必要のある条件を表す AccessCondition オブジェクトです。 null の場合、条件は使用されません。

options

BlobRequestOptions

要求の追加オプションを指定する BlobRequestOptions オブジェクトです。 の場合 null、既定のオプションが要求に適用されます。

operationContext

OperationContext

現在の操作のコンテキストを表す OperationContext オブジェクトです。

戻り値

CloudBlobStream

CloudBlobStream オブジェクト。

属性

DoesServiceRequestAttribute

注釈

このメソッドは常に、 メソッドの呼び出しを FetchAttributes(AccessCondition, BlobRequestOptions, OperationContext) 行います。

このメソッドを StreamWriteSizeInBytes 呼び出す前に プロパティを設定して、書き込むブロック サイズ (バイト単位) を 16 KB から 4 MB までの範囲で指定します。

BLOB が上書きされる代わりに存在する場合に例外をスローするには、 を使用してGenerateIfNotExistsCondition()生成されたオブジェクトをAccessCondition渡します。