File.OpenText(String) File.OpenText(String) File.OpenText(String) File.OpenText(String) Method

Définition

Ouvre un fichier texte encodé en UTF-8 existant pour lecture.Opens an existing UTF-8 encoded text file for reading.

public:
 static System::IO::StreamReader ^ OpenText(System::String ^ path);
public static System.IO.StreamReader OpenText (string path);
static member OpenText : string -> System.IO.StreamReader
Public Shared Function OpenText (path As String) As StreamReader

Paramètres

path
String String String String

Fichier à ouvrir pour lecture.The file to be opened for reading.

Retours

Élément StreamReader sur le chemin d'accès spécifié.A StreamReader on the specified path.

Exceptions

L'appelant n'a pas l'autorisation requise.The caller does not have the required permission.

path est une chaîne de longueur nulle, contient seulement un espace, ou contient un ou plusieurs caractères non valides tels que définis par InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.The specified path, file name, or both exceed the system-defined maximum length.

Le chemin spécifié n’est pas valide (par exemple, il est sur un lecteur non mappé).The specified path is invalid, (for example, it is on an unmapped drive).

Le fichier spécifié dans path est introuvable.The file specified in path was not found.

path a un format non valide.path is in an invalid format.

Exemples

L’exemple suivant ouvre un fichier texte pour la lecture.The following example opens a text file for reading.

using namespace System;
using namespace System::IO;
using namespace System::Text;
int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   
   if ( !File::Exists( path ) )
   {
      // Create the file.
      FileStream^ fs = File::Create( path );
      try
      {
         array<Byte>^info = (gcnew UTF8Encoding( true ))->GetBytes( "This is some text in the file." );
         
         // Add some information to the file.
         fs->Write( info, 0, info->Length );
      }
      finally
      {
         if ( fs )
            delete (IDisposable^)fs;
      }
   }
   
   // Open the stream and read it back.
   StreamReader^ sr = File::OpenText( path );
   try
   {
      String^ s = "";
      while ( s = sr->ReadLine() )
      {
         Console::WriteLine( s );
      }
   }
   finally
   {
      if ( sr )
         delete (IDisposable^)sr;
   }
}
using System;
using System.IO;
using System.Text;

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

        if (!File.Exists(path)) 
        {
            // Create the file.
            using (FileStream fs = File.Create(path)) 
            {
                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 (StreamReader sr = File.OpenText(path)) 
        {
            string s = "";
            while ((s = sr.ReadLine()) != null) 
            {
                Console.WriteLine(s);
            }
        }
    }
}
Imports System.IO
Imports System.Text

Public Class Test
  Public Shared Sub Main()
    Dim path As String = "c:\temp\MyTest.txt"

    If Not File.Exists(path) Then
      ' Create the file.
      Using fs As FileStream = File.Create(path)
        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)
      End Using
    End If

    ' Open the stream and read it back. 
    Using sr As StreamReader = File.OpenText(path)
      Do While sr.Peek() >= 0
        Console.WriteLine(sr.ReadLine())
      Loop
    End Using

  End Sub
End Class

Remarques

Cette méthode est équivalente à StreamReader(String) la surcharge du constructeur.This method is equivalent to the StreamReader(String) constructor overload.

Le path paramètre est autorisé à spécifier des informations relatives au chemin d’accès relatif ou absolu.The path parameter is permitted to specify relative or absolute path information. Les informations relatives au chemin d’accès relatif sont interprétées par rapport au répertoire de travail actuel.Relative path information is interpreted as relative to the current working directory. Pour obtenir le répertoire de travail actuel, GetCurrentDirectoryconsultez.To obtain the current working directory, see GetCurrentDirectory.

Pour obtenir la liste des tâches d’e/s courantes, consultez tâches d’e/s courantes.For a list of common I/O tasks, see Common I/O Tasks.

Sécurité

FileIOPermission
pour la lecture à partir du fichier spécifié.for reading from the specified file. Énumération associée:ReadAssociated enumeration: Read

S’applique à

Voir aussi