IsolatedStorageFileStream::Handle Property

.NET Framework (current version)

Note: This API is now obsolete.

Gets the file handle for the file that the current IsolatedStorageFileStream object encapsulates. Accessing this property is not permitted on an IsolatedStorageFileStream object, and throws an IsolatedStorageException.

Namespace: System.IO.IsolatedStorage
Assembly: mscorlib (in mscorlib.dll)

Syntax

C++

public:
[ObsoleteAttribute("This property has been deprecated.  Please use IsolatedStorageFileStream's SafeFileHandle property instead.  http://go.microsoft.com/fwlink/?linkid=14202")]
property IntPtr Handle {
	[SecurityCriticalAttribute]
	[SecurityPermissionAttribute(SecurityAction::InheritanceDemand, 
		Flags = SecurityPermissionFlag::UnmanagedCode)]
	virtual IntPtr get() override;
}

Property Value

Type: System::IntPtr

The file handle for the file that the current IsolatedStorageFileStream object encapsulates.

Exceptions

Exception	Condition
IsolatedStorageException	The Handle property always generates this exception.

Remarks

For more information, see Handle.

Examples

The following code example demonstrates the Handle property.

C++

[SecurityPermissionAttribute(SecurityAction::Demand, Flags=SecurityPermissionFlag::UnmanagedCode)]
bool GetPrefsForUser()
{
   try
   {

      // Retrieve an IsolatedStorageFile for the current Domain and Assembly.
      IsolatedStorageFile^ isoFile = IsolatedStorageFile::GetStore( static_cast<IsolatedStorageScope>(IsolatedStorageScope::User | IsolatedStorageScope::Assembly | IsolatedStorageScope::Domain), (Type^)nullptr, nullptr );
      IsolatedStorageFileStream^ isoStream = gcnew IsolatedStorageFileStream( this->userName,FileMode::Open,FileAccess::ReadWrite,isoFile );

      // farThe code executes to this point only if a file corresponding to the username exists.
      // Though you can perform operations on the stream, you cannot get a handle to the file.
      try
      {
         IntPtr aFileHandle = isoStream->Handle;
         Console::WriteLine( "A pointer to a file handle has been obtained. {0} {1}", aFileHandle, aFileHandle.GetHashCode() );
      }
      catch ( Exception^ e ) 
      {

         // Handle the exception.
         Console::WriteLine( "Expected exception" );
         Console::WriteLine( e->ToString() );
      }

      StreamReader^ reader = gcnew StreamReader( isoStream );

      // Read the data.
      this->NewsUrl = reader->ReadLine();
      this->SportsUrl = reader->ReadLine();
      reader->Close();
      isoFile->Close();
      isoStream->Close();
      return false;
   }
   catch ( Exception^ e ) 
   {

      // Expected exception if a file cannot be found. This indicates that we have a new user.
      String^ errorMessage = e->ToString();
      return true;
   }

}