FileInfo.Open Método

Definição

Espaço de Nomes:: System.IO

Assemblagens:: mscorlib.dll, System.IO.FileSystem.dll

Assemblagem:: mscorlib.dll

Assemblagem:: System.IO.FileSystem.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Abre um ficheiro com vários privilégios de leitura/escrita e partilha.

Sobrecargas

Name	Description
Open(FileMode)	Abre um ficheiro no modo especificado.
Open(FileMode, FileAccess)	Abre um ficheiro no modo especificado com acesso de leitura, escrita ou leitura/escrita.
Open(FileMode, FileAccess, FileShare)	Abre um ficheiro no modo especificado com acesso de leitura, escrita ou leitura/escrita e a opção de partilha especificada.

Open(FileMode)

Abre um ficheiro no modo especificado.

public:
 System::IO::FileStream ^ Open(System::IO::FileMode mode);

public System.IO.FileStream Open(System.IO.FileMode mode);

member this.Open : System.IO.FileMode -> System.IO.FileStream

Public Function Open (mode As FileMode) As FileStream

Parâmetros

mode: FileMode

Uma FileMode constante que especifica o modo (por exemplo, Open ou Append) em que abrir o ficheiro.

Devoluções

FileStream

Um ficheiro aberto no modo especificado, com acesso de leitura/escrita e não partilhado.

Exceções

FileNotFoundException

O ficheiro não é encontrado.

UnauthorizedAccessException

O ficheiro é apenas de leitura ou é um diretório.

DirectoryNotFoundException

O caminho especificado é inválido, como se estivesse num disco não mapeado.

IOException

O ficheiro já está aberto.

Exemplos

O exemplo seguinte abre um ficheiro, adiciona alguma informação ao ficheiro e lê o ficheiro.

using System;
using System.IO;
using System.Text;

class Test
{
    
    public static void Main()
    {
        string path = @"c:\MyTest.txt";
        FileInfo fi = new FileInfo(path);

        // Delete the file if it exists.
        if (!fi.Exists)
        {
            //Create the file.
            using (FileStream fs = fi.Create())
            {
                Byte[] info = new UTF8Encoding(true).GetBytes("This is some text in the file.");
                //Add some information to the file.
                fs.Write(info, 0, info.Length);
            }
        }

        //Open the stream and read it back.
        using (FileStream fs = fi.Open(FileMode.Open))
        {
            byte[] b = new byte[1024];
            UTF8Encoding temp = new UTF8Encoding(true);
            while (fs.Read(b,0,b.Length) > 0)
            {
                Console.WriteLine(temp.GetString(b));
            }
        }
    }
}
//This code produces output similar to the following;
//results may vary based on the computer/file structure/etc.:
//
//This is some text in the file.
//
//
//
//
//
//
//
//
//
//
//
//

Imports System.IO
Imports System.Text

Public Class Test

    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"
        Dim fi As FileInfo = New FileInfo(path)
        Dim fs As FileStream

        ' Delete the file if it exists.
        If fi.Exists = False Then
            'Create the file.
            fs = fi.Create()
            Dim info As Byte() = New UTF8Encoding(True).GetBytes("This is some text in the file.")
            'Add some information to the file.
            fs.Write(info, 0, info.Length)
            fs.Close()
        End If

        'Open the stream and read it back.
        fs = fi.Open(FileMode.Open)
        Dim b(1023) As Byte
        Dim temp As UTF8Encoding = New UTF8Encoding(True)
        Do While fs.Read(b, 0, b.Length) > 0
            Console.WriteLine(temp.GetString(b))
        Loop
        fs.Close()
    End Sub
End Class
'This code produces output similar to the following; 
'results may vary based on the computer/file structure/etc.:
'
'This is some text in the file.
'
'
'
'
'
'
'
'
'
'
'
'

Ver também

Aplica-se a

Open(FileMode, FileAccess)

Abre um ficheiro no modo especificado com acesso de leitura, escrita ou leitura/escrita.

public:
 System::IO::FileStream ^ Open(System::IO::FileMode mode, System::IO::FileAccess access);

public System.IO.FileStream Open(System.IO.FileMode mode, System.IO.FileAccess access);

member this.Open : System.IO.FileMode * System.IO.FileAccess -> System.IO.FileStream

Public Function Open (mode As FileMode, access As FileAccess) As FileStream

Parâmetros

mode: FileMode

Uma FileMode constante que especifica o modo (por exemplo, Open ou Append) em que abrir o ficheiro.

access: FileAccess

Uma FileAccess constante que especifica se deve abrir o ficheiro com Read, Write, ou ReadWrite aceder ao ficheiro.

Devoluções

FileStream

Um FileStream objeto aberto no modo e acesso especificados, e não partilhado.

Exceções

SecurityException

O interlocutor não tem a permissão necessária.

FileNotFoundException

O ficheiro não é encontrado.

UnauthorizedAccessException

Name é apenas leitura ou é um diretório.

DirectoryNotFoundException

O caminho especificado é inválido, como se estivesse num disco não mapeado.

IOException

O ficheiro já está aberto.

ArgumentException

Name é vazio ou contém apenas espaços em branco.

ArgumentNullException

Um ou mais argumentos são nulos.

Exemplos

O exemplo seguinte abre um ficheiro como apenas leitura e lê a partir do ficheiro.

using System;
using System.IO;
using System.Text;

class Test
{
    
    public static void Main()
    {
        string path = @"c:\MyTest.txt";
        FileInfo fi = new FileInfo(path);

        // Delete the file if it exists.
        if (!fi.Exists)
        {
            //Create the file.
            using (FileStream fs = fi.Create())
            {
                Byte[] info = new UTF8Encoding(true).GetBytes("This is some text in the file.");
                //Add some information to the file.
                fs.Write(info, 0, info.Length);
            }
        }

        //Open the stream and read it back.
        using (FileStream fs = fi.Open(FileMode.Open, FileAccess.Read))
        {
            byte[] b = new byte[1024];
            UTF8Encoding temp = new UTF8Encoding(true);
            while (fs.Read(b,0,b.Length) > 0)
            {
                Console.WriteLine(temp.GetString(b));
            }

            try
            {
                //Try to write to the file.
                fs.Write(b,0,b.Length);
            }
            catch (Exception e)
            {
                Console.WriteLine("Writing was disallowed, as expected: {0}",
                    e.ToString());
            }
        }
    }
}
//This code produces output similar to the following;
//results may vary based on the computer/file structure/etc.:
//
//This is some text in the file.
//
//
//
//
//
//
//
//
//
//
//
//
//Writing was disallowed, as expected: System.NotSupportedException: Stream does
//not support writing.
//   at System.IO.__Error.WriteNotSupported()
//   at System.IO.FileStream.Write(Byte[] array, Int32 offset, Int32 count)
//   at Test.Main() in C:\Documents and Settings\My Computer\My Documents\
//Visual Studio 2005\Projects\finfo open2\finfo open2\Program.cs:line 39

imports System.IO
imports System.Text

Public Class Test
    Public Shared Sub Main()
        Dim path As String = "c:\MyTest.txt"
        Dim fi As FileInfo = new FileInfo(path)
        Dim fs As FileStream

        ' Delete the file if it exists.
        If fi.Exists = False
            'Create the file.
            fs = fi.Create()
            Dim info As Byte() = _
                    New UTF8Encoding(true).GetBytes( _
                        "This is some text in the file.")

            'Add some information to the file.
            fs.Write(info, 0, info.Length)
            fs.Close()
        End If

        'Open the stream and read it back.
        fs = fi.Open(FileMode.Open, FileAccess.Read)
        Dim b(1023) As byte
        Dim temp As UTF8Encoding = New UTF8Encoding(true)

        Do While fs.Read(b,0,b.Length) > 0
            Console.WriteLine(temp.GetString(b))
        Loop
            Try
                fs.Write(b,0,b.Length)
                Catch e As Exception
                Console.WriteLine("Writing was disallowed, as expected: {0}", e.ToString())
            End Try
        fs.Close()
    End Sub
End Class
'This code produces output similar to the following; 
'results may vary based on the computer/file structure/etc.:
'
'This is some text in the file.
'
'
'
'
'
'
'
'
'
'
'
'
'Writing was disallowed, as expected: System.NotSupportedException: Stream does 
'not support writing.
'   at System.IO.__Error.WriteNotSupported()
'   at System.IO.FileStream.Write(Byte[] array, Int32 offset, Int32 count)
'   at VB_Console_Application.Test.Main() in C:\Documents and Settings\MyComputer
'\My Documents\Visual Studio 2005\Projects\finfo open2\finfo open2\Module1.vb:line 34
'

Ver também

Aplica-se a

Open(FileMode, FileAccess, FileShare)

Abre um ficheiro no modo especificado com acesso de leitura, escrita ou leitura/escrita e a opção de partilha especificada.

public:
 System::IO::FileStream ^ Open(System::IO::FileMode mode, System::IO::FileAccess access, System::IO::FileShare share);

public System.IO.FileStream Open(System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share);

member this.Open : System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare -> System.IO.FileStream

Public Function Open (mode As FileMode, access As FileAccess, share As FileShare) As FileStream

Parâmetros

mode: FileMode

Uma FileMode constante que especifica o modo (por exemplo, Open ou Append) em que abrir o ficheiro.

access: FileAccess

Uma FileAccess constante que especifica se deve abrir o ficheiro com Read, Write, ou ReadWrite aceder ao ficheiro.

share: FileShare

Uma constante que especifica o tipo de acesso que FileShare outros FileStream objetos têm a este ficheiro.

Devoluções

FileStream

Um objeto abria-se FileStream com o modo, acesso e opções de partilha especificados.

Exceções

SecurityException

O interlocutor não tem a permissão necessária.

FileNotFoundException

O ficheiro não é encontrado.

UnauthorizedAccessException

Name é apenas leitura ou é um diretório.

DirectoryNotFoundException

O caminho especificado é inválido, como se estivesse num disco não mapeado.

IOException

O ficheiro já está aberto.

ArgumentException

Name é vazio ou contém apenas espaços em branco.

ArgumentNullException

Um ou mais argumentos são nulos.

Exemplos

O exemplo seguinte demonstra abrir um ficheiro para leitura e escrita, mas impedir o acesso a outros utilizadores ou processos.

using System;
using System.IO;

public class OpenTest
{
    public static void Main()
    {
        // Open an existing file, or create a new one.
        FileInfo fi = new FileInfo("temp.txt");

        // Open the file just specified such that no one else can use it.
        FileStream fs = fi.Open( FileMode.OpenOrCreate, FileAccess.ReadWrite, FileShare.None );

        // Create another reference to the same file.
        FileInfo nextfi = new FileInfo("temp.txt");

        try
        {
            // Try opening the same file, which was locked by the previous process.
            nextfi.Open( FileMode.OpenOrCreate, FileAccess.Read );

            Console.WriteLine("The file was not locked, and was opened by a second process.");
        }
        catch (IOException)
        {
            Console.WriteLine("The file could not be opened because it was locked by another process.");
        }
        catch (Exception e)
        {
            Console.WriteLine(e.ToString());
        }

        // Close the file so it can be deleted.
        fs.Close();
    }
}

//This code produces output similar to the following;
//results may vary based on the computer/file structure/etc.:
//
//The file could not be opened because it was locked by another process.

Imports System.IO

Public Class OpenTest

    Public Shared Sub Main()
        ' Open an existing file, or create a new one.
        Dim fi As New FileInfo("temp.txt")

        ' Open the file just specified such that no one else can use it.
        Dim fs As FileStream = fi.Open(FileMode.OpenOrCreate, FileAccess.ReadWrite, FileShare.None)

        ' Create another reference to the same file.
        Dim nextfi As New FileInfo("temp.txt")

        Try
            ' Try opening the same file, which was locked by the previous process.
            nextfi.Open(FileMode.OpenOrCreate, FileAccess.Read)
            Console.WriteLine("The file was not locked, and was opened by a second process.")
        Catch i as IOException
            Console.WriteLine(i.ToString())
        Catch e As Exception
            Console.WriteLine(e.ToString())
        End Try

        ' Close the file so it can be deleted.
        fs.Close()
    End Sub
End Class
'This code produces output similar to the following; 
'results may vary based on the computer/file structure/etc.:
'
'System.IO.IOException: The process cannot access the file 
''C:\Documents and Settings\mydirectory\My Documents\Visual Studio 2005
'\Projects\fileinfoopen\fileinfoopen\obj\Release\temp.txt' 
'because it is being used by another process.
'at System.IO.__Error.WinIOError(Int32 errorCode, String maybeFullPath)
'at System.IO.FileStream.Init(String path, FileMode mode, FileAccess access, 
'Int32 rights, Boolean useRights, FileShare share, Int32 bufferSize, FileOptions
'options, SECURITY_ATTRIBUTES secAttrs, String msgPath, Boolean bFromProxy)
'at System.IO.FileStream..ctor(String path, FileMode mode, FileAccess access,
'FileShare share) at System.IO.FileInfo.Open(FileMode mode, FileAccess access)
'at VB_Console_Application.OpenTest.Main() in C:\Documents and Settings
'\mydirectory\My Documents\Visual Studio 2005\Projects\VB_Console_Application
'\VB_Console_Application\Module1.vb:line 19

Ver também

Aplica-se a

Comentários

Esta página foi útil?