CloudBlobClient.GetBlobReference Method (String)
From Storage Client Library NET API
Returns a reference to a CloudBlob with the specified address.
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 returnValue As CloudBlob returnValue = instance.GetBlobReference(blobAddress) |
Syntax
| Visual Basic |
|---|
Public Function GetBlobReference ( _ blobAddress As String _ ) As CloudBlob |
| C# |
|---|
public CloudBlob GetBlobReference ( string blobAddress ) |
| C++ |
|---|
public: CloudBlob^ GetBlobReference ( String^ blobAddress ) |
| J# |
|---|
| JScript |
|---|
Parameters
- blobAddress
Type: System.String
The absolute URI to the blob, or a relative URI beginning with the container name.
Return Value
Type: Microsoft.WindowsAzure.StorageClient.CloudBlob
A reference to a blob.
Example
The following example shows two ways to call the GetBlobReference method.
| C# | Copy Code |
|---|---|
//Get a reference to a blob using a relative address.
CloudBlob publicBlob = publicClient.GetBlobReference("mypubliccontainer/publicBlob.txt");
//Get a reference to a blob using an absolute address.
CloudBlob publicBlob = publicClient.GetBlobReference("https://storagesample.blob.core.windows.net/mypubliccontainer/publicBlob.txt");
| |
Remarks
The GetBlobReference method returns a reference to the named 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.