CloudBlobClient.GetPageBlobReference Method (String, Nullable)
From Storage Client Library NET API
Returns a reference to a CloudPageBlob object with the specified address, and with the specified snapshot timestamp, if the blob is a snapshot.
Namespace: Microsoft.WindowsAzure.StorageClient
Assembly: Microsoft.WindowsAzure.StorageClient (in Microsoft.WindowsAzure.StorageClient.dll)
Usage
| Visual Basic |
|---|
Dim instance As CloudBlobClient Dim blobAddress As String Dim snapshotTime As Nullable(Of DateTime) Dim returnValue As CloudPageBlob returnValue = instance.GetPageBlobReference(blobAddress, snapshotTime) |
Syntax
| Visual Basic |
|---|
Public Function GetPageBlobReference ( _ blobAddress As String, _ snapshotTime As Nullable(Of DateTime) _ ) As CloudPageBlob |
| C# |
|---|
public CloudPageBlob GetPageBlobReference ( string blobAddress, Nullable<DateTime> snapshotTime ) |
| C++ |
|---|
public: CloudPageBlob^ GetPageBlobReference ( String^ blobAddress, Nullable<DateTime> snapshotTime ) |
| J# |
|---|
| JScript |
|---|
Parameters
- blobAddress
Type: System.String
The absolute URI to the blob, or a relative URI beginning with the container name.
- snapshotTime
Type: System.Nullable
The snapshot timestamp, if the blob is a snapshot.
Return Value
Type: Microsoft.WindowsAzure.StorageClient.CloudPageBlob
A reference to a page blob.
Remarks
The GetPageBlobReference method returns a reference to the named page blob, but it does not indicate whether the blob exists, as it does not make a round-trip to the service. If you need to ascertain the blob's existence, call a method such as FetchAttributes, and handle the resulting StorageClientException in the event the blob does not exist. The FetchAttributes method executes a HEAD request to populate the blob's properties and metadata and as such is a lightweight option for determining whether the blob exists.