FileSystem.ReadAllText Yöntem

Tanım

Ad Alanı:

Microsoft.VisualBasic.FileIO

Bütünleştirilmiş Kod:

Microsoft.VisualBasic.Core.dll

Metin dosyasının içeriğini olarak Stringdöndürür.

Aşırı Yüklemeler

ReadAllText(String)	Metin dosyasının içeriğini olarak Stringdöndürür.
ReadAllText(String, Encoding)	Metin dosyasının içeriğini olarak Stringdöndürür.

ReadAllText(String)

Kaynak:

FileSystem.vb

Metin dosyasının içeriğini olarak Stringdöndürür.

public:
 static System::String ^ ReadAllText(System::String ^ file);

public static string ReadAllText (string file);

static member ReadAllText : string -> string

Public Shared Function ReadAllText (file As String) As String

Parametreler

file

String

Okunacak dosyanın adı ve yolu.

Döndürülenler

String

String dosyasının içeriğini içerir.

Özel durumlar

ArgumentException

Yol aşağıdaki nedenlerden biri için geçerli değildir: sıfır uzunlukta bir dizedir; yalnızca boşluk içerir; geçersiz karakterler içeriyor; veya bir cihaz yoludur (\\.\ile başlar); sonunda eğik çizgiyle biter.

ArgumentNullException

file, Nothing değeridir.

FileNotFoundException

Dosya yok.

IOException

Dosya başka bir işlem tarafından kullanılıyor veya G/Ç hatası oluşuyor.

PathTooLongException

Yol, sistem tarafından tanımlanan uzunluk üst sınırını aşıyor.

NotSupportedException

Yoldaki bir dosya veya dizin adı iki nokta üst üste (:) veya geçersiz biçimdedir) içeriyor.

OutOfMemoryException

Dizeyi arabelleğe yazmak için yeterli bellek yok.

SecurityException

Kullanıcının yolu görüntülemek için gerekli izinleri yok.

Örnekler

Bu örnek içindekileri Test.txt bir dizede okur ve bir ileti kutusunda görüntüler.

Dim reader = My.Computer.FileSystem.ReadAllText("C:\test.txt")
MsgBox(reader)

Bu örnek, ASCII dosyasının Test.txt içeriğini bir dizede okur ve bir ileti kutusunda görüntüler.

Dim reader = My.Computer.FileSystem.ReadAllText("C:\test.txt",
   System.Text.Encoding.ASCII)
MsgBox(reader)

Açıklamalar

ReadAllText nesnesinin My.Computer.FileSystem yöntemi, bir metin dosyasından okumanızı sağlar. Dosyanın içeriği dize olarak döndürülür.

Dosyanın içeriği ASCII veya UTF-8 gibi bir kodlamadaysa dosya kodlaması belirtilebilir. Genişletilmiş karakterler içeren bir dosyadan okuyorsanız, yönteminin başka bir aşırı yüklemesini kullanarak dosya kodlamasını ReadAllText belirtmeniz gerekir.

Dosya adına dayanarak dosyanın içeriği ile ilgili kararlar vermeyin. Örneğin, dosya Form1.vb bir Visual Basic kaynak dosyası olmayabilir. Verileri uygulamanızda kullanmadan önce tüm girişleri doğrulayın.

Aşağıdaki tabloda, yöntemini içeren bir görev örneği liste verilmiştir My.Computer.FileSystem.ReadAllText .

Amaç	Bkz.
Bir metin dosyasından okuma	Nasıl Yapılır: Visual Basic'te Metin Dosyalarını Okuma

Ayrıca bkz.

• Encoding
• ReadAllText
• StreamReader(Stream, Encoding)

ReadAllText(String, Encoding)

Kaynak:

FileSystem.vb

Metin dosyasının içeriğini olarak Stringdöndürür.

public:
 static System::String ^ ReadAllText(System::String ^ file, System::Text::Encoding ^ encoding);

public static string ReadAllText (string file, System.Text.Encoding encoding);

static member ReadAllText : string * System.Text.Encoding -> string

Public Shared Function ReadAllText (file As String, encoding As Encoding) As String

Parametreler

file

String

Okunacak dosyanın adı ve yolu.

encoding

Encoding

Dosyayı okurken kullanılacak karakter kodlaması. Varsayılan değer UTF-8'dir.

Döndürülenler

String

String dosyasının içeriğini içerir.

Özel durumlar

ArgumentException

Yol aşağıdaki nedenlerden biri için geçerli değildir: sıfır uzunlukta bir dizedir; yalnızca boşluk içerir; geçersiz karakterler içeriyor; veya bir cihaz yoludur (\\.\ile başlar); sonunda eğik çizgiyle biter.

ArgumentNullException

file, Nothing değeridir.

FileNotFoundException

Dosya yok.

IOException

Dosya başka bir işlem tarafından kullanılıyor veya G/Ç hatası oluşuyor.

PathTooLongException

Yol, sistem tarafından tanımlanan uzunluk üst sınırını aşıyor.

NotSupportedException

Yoldaki bir dosya veya dizin adı iki nokta üst üste (:) veya geçersiz biçimdedir) içeriyor.

OutOfMemoryException

Dizeyi arabelleğe yazmak için yeterli bellek yok.

SecurityException

Kullanıcının yolu görüntülemek için gerekli izinleri yok.

Örnekler

Bu örnek içindekileri Test.txt bir dizede okur ve bir ileti kutusunda görüntüler.

Dim reader = My.Computer.FileSystem.ReadAllText("C:\test.txt")
MsgBox(reader)

Bu örnek, ASCII dosyasının Test.txt içeriğini bir dizede okur ve bir ileti kutusunda görüntüler.

Dim reader = My.Computer.FileSystem.ReadAllText("C:\test.txt",
   System.Text.Encoding.ASCII)
MsgBox(reader)

Açıklamalar

ReadAllText nesnesinin My.Computer.FileSystem yöntemi, bir metin dosyasından okumanızı sağlar. Dosyanın içeriği dize olarak döndürülür.

Dosyanın içeriği ASCII veya UTF-8 gibi bir kodlamadaysa dosya kodlaması belirtilebilir. Genişletilmiş karakterler içeren bir dosyadan okuyorsanız, dosya kodlamasını belirtmeniz gerekir.

Dosya adına dayanarak dosyanın içeriği ile ilgili kararlar vermeyin. Örneğin, dosya Form1.vb bir Visual Basic kaynak dosyası olmayabilir. Verileri uygulamanızda kullanmadan önce tüm girişleri doğrulayın.

Aşağıdaki tabloda, yöntemini içeren bir görev örneği liste verilmiştir My.Computer.FileSystem.ReadAllText .

Amaç	Bkz.
Bir metin dosyasından okuma	Nasıl Yapılır: Visual Basic'te Metin Dosyalarını Okuma

Ayrıca bkz.

• Encoding
• StreamReader(Stream, Encoding)