RoleEnvironment::GetLocalResource Method (String^)
Retrieves a specified local storage resource.
Assembly: Microsoft.WindowsAzure.ServiceRuntime (in Microsoft.WindowsAzure.ServiceRuntime.dll)
public: [SecurityPermissionAttribute(SecurityAction::Assert, UnmanagedCode = true)] static LocalResource^ GetLocalResource( String^ localResourceName )
Parameters
- localResourceName
-
Type:
System::String^
Type: System.String
The name of the local storage resource that is defined in the ServiceDefiniton.csdef file.
Return Value
Type: Microsoft.WindowsAzure.ServiceRuntime::LocalResource^Type: Microsoft.WindowsAzure.ServiceRuntime.LocalResource
An instance of LocalResource that represents the local storage resource.
| Exception | Condition |
|---|---|
| RoleEnvironmentException | The local storage resource does not exist. |
The following code example shows how to use this method to retrieve the local storage resource and write a text file to the resource:
try { // Retrieve an object that points to the local storage resource. LocalResource localResource = RoleEnvironment.GetLocalResource("localStoreTwo"); // Define the file name and path. string[] paths = { localResource.RootPath, "MyStorageTest.txt" }; String filePath = Path.Combine(paths); using (FileStream writeStream = File.Create(filePath)) { Byte[] textToWrite = new UTF8Encoding(true).GetBytes("Testing Web role storage"); writeStream.Write(textToWrite, 0, textToWrite.Length); } } catch (RoleEnvironmentException e) { Console.WriteLine("The local resource isn't defined or doesn't exist. \n" + e.ToString()); }
Show: