FileIOPermission.SetPathList Método

Definição

Namespace:

System.Security.Permissions

Assembly:

System.Security.Permissions.dll

Define o acesso especificado ao arquivo ou diretório indicado, substituindo o estado existente da permissão.

Sobrecargas

SetPathList(FileIOPermissionAccess, String)	Define o acesso especificado ao arquivo ou diretório especificado, substituindo o estado existente da permissão.
SetPathList(FileIOPermissionAccess, String[])	Define o acesso especificado aos arquivos e diretórios especificados, substituindo o estado atual para o acesso especificado pelo novo conjunto de caminhos.

SetPathList(FileIOPermissionAccess, String)

Origem:

FileIOPermission.cs

Define o acesso especificado ao arquivo ou diretório especificado, substituindo o estado existente da permissão.

public:
 void SetPathList(System::Security::Permissions::FileIOPermissionAccess access, System::String ^ path);

public void SetPathList (System.Security.Permissions.FileIOPermissionAccess access, string path);

member this.SetPathList : System.Security.Permissions.FileIOPermissionAccess * string -> unit

Public Sub SetPathList (access As FileIOPermissionAccess, path As String)

Parâmetros

access

FileIOPermissionAccess

Uma combinação bit a bit dos valores FileIOPermissionAccess.

path

String

O caminho absoluto do arquivo ou diretório.

Exceções

ArgumentException

O parâmetro access não é um valor válido de FileIOPermissionAccess.

- ou -

O parâmetro path não é uma cadeia de caracteres válida.

- ou -

O parâmetro path não especificou o caminho absoluto para o arquivo ou diretório.

Exemplos

O exemplo de código a seguir mostra o uso do FileIOPermission.SetPathList(FileIOPermissionAccess, String) método .

bool SetGetPathListDemo()
{
   try
   {
      Console::WriteLine( "********************************************************\n" );
      FileIOPermission^ fileIOPerm1;
      Console::WriteLine( "Creating a FileIOPermission with AllAccess rights for 'C:\\Examples\\Test\\TestFile.txt" );
      
      fileIOPerm1 = gcnew FileIOPermission( FileIOPermissionAccess::AllAccess,"C:\\Examples\\Test\\TestFile.txt" );
      
      Console::WriteLine( "Adding 'C:\\Temp' to the write access list, and \n 'C:\\Examples\\Test' to read access." );
      fileIOPerm1->AddPathList( FileIOPermissionAccess::Write, "C:\\Temp" );
      fileIOPerm1->AddPathList( FileIOPermissionAccess::Read, "C:\\Examples\\Test" );
      array<String^>^paths = fileIOPerm1->GetPathList( FileIOPermissionAccess::Read );
      Console::WriteLine( "Read access before SetPathList = " );
      IEnumerator^ myEnum = paths->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         String^ path = safe_cast<String^>(myEnum->Current);
         Console::WriteLine( "\t{0}", path );
      }

      Console::WriteLine( "Setting the read access list to \n'C:\\Temp'" );
      fileIOPerm1->SetPathList( FileIOPermissionAccess::Read, "C:\\Temp" );
      paths = fileIOPerm1->GetPathList( FileIOPermissionAccess::Read );
      Console::WriteLine( "Read access list after SetPathList = " );
      IEnumerator^ myEnum1 = paths->GetEnumerator();
      while ( myEnum1->MoveNext() )
      {
         String^ path = safe_cast<String^>(myEnum1->Current);
         Console::WriteLine( "\t{0}", path );
      }

      paths = fileIOPerm1->GetPathList( FileIOPermissionAccess::Write );
      Console::WriteLine( "Write access list after SetPathList = " );
      IEnumerator^ myEnum2 = paths->GetEnumerator();
      while ( myEnum2->MoveNext() )
      {
         String^ path = safe_cast<String^>(myEnum2->Current);
         Console::WriteLine( "\t{0}", path );
      }

      Console::WriteLine( "Write access = \n{0}", fileIOPerm1->GetPathList( FileIOPermissionAccess::AllAccess ) );
   }
   catch ( ArgumentException^ e ) 
   {
      
      // FileIOPermissionAccess.AllAccess can not be used as a parameter for GetPathList.
      Console::WriteLine( "An ArgumentException occurred as a result of using AllAccess. This property cannot be used as a parameter in GetPathList because it represents more than one type of file variable access. : \n{0}", e );
   }

   return true;
}

private bool SetGetPathListDemo()
{
    try
    {
        Console.WriteLine("********************************************************\n");

        FileIOPermission fileIOPerm1;
        Console.WriteLine("Creating a FileIOPermission with AllAccess rights for 'C:\\Examples\\Test\\TestFile.txt");
        fileIOPerm1 = new FileIOPermission(FileIOPermissionAccess.AllAccess, "C:\\Examples\\Test\\TestFile.txt");
        Console.WriteLine("Adding 'C:\\Temp' to the write access list, and \n 'C:\\Examples\\Test' to read access.");
        fileIOPerm1.AddPathList(FileIOPermissionAccess.Write, "C:\\Temp");
        fileIOPerm1.AddPathList(FileIOPermissionAccess.Read, "C:\\Examples\\Test");
        string[] paths = fileIOPerm1.GetPathList(FileIOPermissionAccess.Read);
        Console.WriteLine("Read access before SetPathList = ");
        foreach (string path in paths)
        {
            Console.WriteLine("\t" + path);
        }
        Console.WriteLine("Setting the read access list to \n'C:\\Temp'");
        fileIOPerm1.SetPathList(FileIOPermissionAccess.Read, "C:\\Temp");
        paths = fileIOPerm1.GetPathList(FileIOPermissionAccess.Read);
        Console.WriteLine("Read access list after SetPathList = ");
        foreach (string path in paths)
        {
            Console.WriteLine("\t" + path);
        }

        paths = fileIOPerm1.GetPathList(FileIOPermissionAccess.Write);
        Console.WriteLine("Write access list after SetPathList = ");
        foreach (string path in paths)
        {
            Console.WriteLine("\t" + path);
        }

        Console.WriteLine("Write access = \n" +
            fileIOPerm1.GetPathList(FileIOPermissionAccess.AllAccess));
    }
    catch (ArgumentException e)
    {
        // FileIOPermissionAccess.AllAccess can not be used as a parameter for GetPathList.
        Console.WriteLine("An ArgumentException occurred as a result of using AllAccess. "
            + "This property cannot be used as a parameter in GetPathList "
            + "because it represents more than one type of file variable access. : \n" + e);
    }

    return true;
}

Private Function SetGetPathListDemo() As Boolean
    Try
        Console.WriteLine("********************************************************" & ControlChars.Lf)

        Dim fileIOPerm1 As FileIOPermission
        Console.WriteLine("Creating a FileIOPermission with AllAccess rights for 'C:\Examples\Test\TestFile.txt")
        fileIOPerm1 = New FileIOPermission(FileIOPermissionAccess.AllAccess, "C:\Examples\Test\TestFile.txt")
        Console.WriteLine("Adding 'C:\Temp' to the write access list, and " & ControlChars.Lf & " 'C:\Examples\Test' to read access.")
        fileIOPerm1.AddPathList(FileIOPermissionAccess.Write, "C:\Temp")
        fileIOPerm1.AddPathList(FileIOPermissionAccess.Read, "C:\Examples\Test")
        Dim paths As String() = fileIOPerm1.GetPathList(FileIOPermissionAccess.Read)
        Console.WriteLine("Read access before SetPathList = ")
        Dim path As String
        For Each path In paths
            Console.WriteLine((ControlChars.Tab & path))
        Next path
        Console.WriteLine("Setting the read access list to " & ControlChars.Lf & "'C:\Temp'")
        fileIOPerm1.SetPathList(FileIOPermissionAccess.Read, "C:\Temp")
        paths = fileIOPerm1.GetPathList(FileIOPermissionAccess.Read)
        Console.WriteLine("Read access list after SetPathList = ")
        For Each path In paths
            Console.WriteLine((ControlChars.Tab & path))
        Next path

        paths = fileIOPerm1.GetPathList(FileIOPermissionAccess.Write)
        Console.WriteLine("Write access list after SetPathList = ")
        For Each path In paths
            Console.WriteLine((ControlChars.Tab & path))
        Next path

        Dim pathList() As String
        pathList = fileIOPerm1.GetPathList(FileIOPermissionAccess.AllAccess)

    Catch e As ArgumentException
        ' FileIOPermissionAccess.AllAccess can not be used as a parameter for GetPathList.
        Console.WriteLine(("An ArgumentException occurred as a result of using AllAccess. " & "This property cannot be used as a parameter in GetPathList " & "because it represents more than one type of file variable access. : " & ControlChars.Lf & e.ToString()))
    End Try

    Return True
End Function 'SetGetPathListDemo

Comentários

O estado anterior da permissão atual para o tipo de acesso especificado é substituído. O código a seguir define o acesso de C:\temp como Read.

fileIOPerm1->SetPathList(FileIOPermissionAccess::Read, "C:\\temp");

fileIOPerm1.SetPathList(FileIOPermissionAccess.Read, "C:\\temp");

fileIOPerm1.SetPathList(FileIOPermissionAccess.Read, "C:\\temp")

Esse acesso não será substituído pelo código a seguir porque os tipos de acesso não são os mesmos.

fileIOPerm1->SetPathList(FileIOPermissionAccess::Write, "C:\\documents");

fileIOPerm1.SetPathList(FileIOPermissionAccess.Write, "C:\\documents");

fileIOPerm1.SetPathList(FileIOPermissionAccess.Write, "C:\\documents")

SetPathList(FileIOPermissionAccess, String[])

Origem:

FileIOPermission.cs

Define o acesso especificado aos arquivos e diretórios especificados, substituindo o estado atual para o acesso especificado pelo novo conjunto de caminhos.

public:
 void SetPathList(System::Security::Permissions::FileIOPermissionAccess access, cli::array <System::String ^> ^ pathList);

public void SetPathList (System.Security.Permissions.FileIOPermissionAccess access, string[] pathList);

member this.SetPathList : System.Security.Permissions.FileIOPermissionAccess * string[] -> unit

Public Sub SetPathList (access As FileIOPermissionAccess, pathList As String())

Parâmetros

access

FileIOPermissionAccess

Uma combinação bit a bit dos valores FileIOPermissionAccess.

pathList

String[]

Uma matriz que contém os caminhos absolutos dos arquivos e diretórios.

Exceções

ArgumentException

O parâmetro access não é um valor válido de FileIOPermissionAccess.

- ou -

Uma entrada no parâmetro pathList não é uma cadeia de caracteres válida.

Comentários

O estado anterior da permissão atual para o tipo de acesso especificado é substituído. O código a seguir define o acesso de C:\temp como Read.

Esse acesso não será substituído pelo código a seguir porque os tipos de acesso não são os mesmos.

fileIOPerm1->SetPathList(FileIOPermissionAccess::Write, gcnew array<String^> {"C:\\pictures", "C:\\music"});

fileIOPerm1.SetPathList(FileIOPermissionAccess.Write, new string[] {"C:\\pictures", "C:\\music"});

fileIOPerm1.SetPathList(FileIOPermissionAccess.Write, New String() {"C:\\pictures", "C:\\music"})