IsolatedStorageFileStream.Handle プロパティ

.NET Framework クラス ライブラリ リファレンス

IsolatedStorageFileStream.Handle プロパティ

メモ : このプロパティは、互換性のために残されています。

現在の IsolatedStorageFileStream オブジェクトによってカプセル化されるファイルのファイル ハンドルを取得します。IsolatedStorageFileStream オブジェクトではこのプロパティへのアクセスは許可されておらず、IsolatedStorageException がスローされます。

名前空間: System.IO.IsolatedStorage
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<ObsoleteAttribute("This property has been deprecated.
  Please use IsolatedStorageFileStream's SafeFileHandle property instead.
  http://go.microsoft.com/fwlink/?linkid=14202")> _
Public Overrides ReadOnly
 Property Handle As IntPtr

Visual Basic (使用法)

Dim instance As IsolatedStorageFileStream
Dim value As IntPtr

value = instance.Handle

C#

[ObsoleteAttribute("This property has been deprecated.  Please use IsolatedStorageFileStream\'s
 SafeFileHandle property instead.  http://go.microsoft.com/fwlink/?linkid=14202")]
 
public override IntPtr Handle { get; }

C++

[ObsoleteAttribute(L"This property has been deprecated.  Please use IsolatedStorageFileStream\'s
 SafeFileHandle property instead.  http://go.microsoft.com/fwlink/?linkid=14202")]
 
public:
virtual property IntPtr Handle {
    IntPtr get () override;
}

J#

/** @property */
public IntPtr get_Handle ()

JScript

public override function get
 Handle () : IntPtr

プロパティ値
現在の IsolatedStorageFileStream オブジェクトによってカプセル化されるファイルのファイル ハンドル。

例外

例外の種類	条件
IsolatedStorageException	Handle プロパティは常にこの例外を生成します。

解説

詳細については、「Handle」を参照してください。

使用例

Handle プロパティのコード例を次に示します。

Visual Basic

Private Function GetPrefsForUser() As
 Boolean
    Try
        ' Retrieve an IsolatedStorageFile for the current Domain and
 Assembly.
        Dim isoFile As IsolatedStorageFile
 = _
            IsolatedStorageFile.GetStore(IsolatedStorageScope.User _
            Or IsolatedStorageScope.Assembly _
            Or IsolatedStorageScope.Domain, Nothing,
 Nothing)

        Dim isoStream As New
 IsolatedStorageFileStream(Me.userName, FileMode.Open, _
            FileAccess.Read, FileShare.Read)
        ' 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

            Dim aFileHandle As SafeFileHandle
 = isoStream.SafeFileHandle
            Console.WriteLine(("A pointer to a file handle has
 been obtained. " & aFileHandle.ToString() & "
 " & aFileHandle.GetHashCode()))

        Catch ex As Exception
            ' Handle the exception.
            Console.WriteLine("Expected exception")
            Console.WriteLine(ex.ToString())
        End Try

        Dim reader As New
 StreamReader(isoStream)
        ' Read the data.
        Me.NewsUrl = reader.ReadLine()
        Me.SportsUrl = reader.ReadLine()
        reader.Close()
        isoFile.Close()
        Return False
    Catch ex As System.IO.FileNotFoundException
        ' Expected exception if a file cannot be found. This indicates
 that we have a new user.
        Return True
    End Try
End Function 'GetPrefsForUser

C#

private bool GetPrefsForUser()
{
    try
    {

        // Retrieve an IsolatedStorageFile for the current Domain and
 Assembly.
        IsolatedStorageFile isoFile =
            IsolatedStorageFile.GetStore(IsolatedStorageScope.User |
            IsolatedStorageScope.Assembly |
            IsolatedStorageScope.Domain,
            null,
            null);

        IsolatedStorageFileStream isoStream =
            new IsolatedStorageFileStream(this.userName
,
            FileMode.Open,
            FileAccess.Read,
            FileShare.Read);

        // The 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
        {

            SafeFileHandle aFileHandle = isoStream.SafeFileHandle;
            Console.WriteLine("A pointer to a file handle has been obtained.
 "
                + aFileHandle.ToString() + " "
                + aFileHandle.GetHashCode());
        }

        catch (Exception e)
        {
            // Handle the exception.
            Console.WriteLine("Expected exception");
            Console.WriteLine(e);
        }

        StreamReader reader = new StreamReader(isoStream);
        // Read the data.
        this.NewsUrl = reader.ReadLine();
        this.SportsUrl = reader.ReadLine();
        reader.Close();
        isoFile.Close();
        return false;
    }
    catch (System.IO.FileNotFoundException)
    {
        // Expected exception if a file cannot be found. This indicates
 that we have a new user.
        return true;
    }
}

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;
   }

}

.NET Framework のセキュリティ

• SecurityPermission  (アンマネージ コードにアクセスするために必要なアクセス許可)。SecurityPermissionFlag.UnmanagedCode (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 1.0、1.1
2.0 では、互換性のために残されています (コンパイル時に警告)

参照

関連項目
IsolatedStorageFileStream クラス
IsolatedStorageFileStream メンバ
System.IO.IsolatedStorage 名前空間