My.Computer.FileSystem.OpenTextFieldParser (Método)
Actualización: noviembre 2007
El método OpenTextFieldParser permite crear un objeto TextFieldParser (Objeto), con el que se consigue un procedimiento sencillo y eficaz para analizar archivos de texto estructurados, como, por ejemplo, registros. El objeto TextFieldParser puede utilizarse para leer archivos de ancho fijo y delimitado.
' Usage
Dim value As TextFieldParser = My.Computer.FileSystem.OpenTextFieldParser(file)
Dim value As TextFieldParser = My.Computer.FileSystem.OpenTextFieldParser(file ,delimiters)
Dim value As TextFieldParser = My.Computer.FileSystem.OpenTextFieldParser(file ,fieldWidths)
' Declaration
Public Function OpenTextFieldParser( _
ByVal file As String _
) As TextFieldParser
' -or-
Public Function OpenTextFieldParser( _
ByVal file As String, _
ByVal delimiters As String() _
) As TextFieldParser
' -or-
Public Function OpenTextFieldParser( _
ByVal file As String, _
ByVal fieldWidths As Integer() _
) As TextFieldParser
Parámetros
file
String. Archivo que se va a abrir con TextFieldParser. Obligatorio.delimiters
String(). Delimitadores para los campos. Obligatorio.fieldWidths
Integer(). Ancho de los campos. Obligatorio.
Valor devuelto
Excepciones
Las condiciones siguientes pueden producir una excepción:
La ruta de acceso no es válida por una de las razones siguientes: es una cadena de longitud cero; sólo contiene un espacio en blanco; contiene caracteres no válidos; o es una ruta de acceso de dispositivo (empieza por \\.\) (ArgumentException).
El nombre de archivo finaliza con una barra diagonal (ArgumentException).
La ruta de acceso no es válida porque es Nothing (ArgumentNullException).
El archivo especificado no existe (FileNotFoundException).
El archivo especificado está en uso (IOException).
La ruta de acceso supera la longitud máxima definida por el sistema (PathTooLongException).
Un nombre de archivo o de directorio de la ruta de acceso contiene un signo de dos puntos (:) o tiene un formato no válido (NotSupportedException).
El usuario no tiene los permisos necesarios para ver la ruta de acceso (SecurityException).
Una fila no se puede analizar utilizando el formato especificado (MalformedLineException). El mensaje de excepción especifica la línea que produce la excepción, mientras que el texto contenido en la línea se asigna a TextFieldParser.ErrorLine (Propiedad).
El usuario no tiene permisos suficientes para el acceso al archivo (UnauthorizedAccessException).
Tareas
En la tabla siguiente se muestran ejemplos de tareas en las que interviene el método My.Computer.FileSystem.OpenTextFieldParser.
Para |
Vea |
---|---|
Leer un archivo de texto delimitado |
Cómo: Leer archivos de texto delimitado por comas en Visual Basic |
Leer un archivo de texto de ancho fijo |
|
Leer un archivo de texto con varios formatos |
Cómo: Leer archivos de texto con varios formatos en Visual Basic |
Ejemplo
En este ejemplo se abre TextFieldParserreader, que se utiliza para leer C:\TestFolder1\Test1.txt.
Dim reader As Microsoft.VisualBasic.FileIO.TextFieldParser
reader = My.Computer.FileSystem.OpenTextFieldParser _
("C:\TestFolder1\test1.txt")
reader.TextFieldType = Microsoft.VisualBasic.FileIO.FieldType.Delimited
reader.delimiters = New String() {","}
Dim currentRow As String()
While Not reader.EndOfData
Try
currentRow = reader.ReadFields()
Dim currentField As String
For Each currentField In currentRow
MsgBox(currentField)
Next
Catch ex As Microsoft.VisualBasic.FileIO.MalformedLineException
MsgBox("Line " & ex.Message & _
"is not valid and will be skipped.")
End Try
End While
Requisitos
Espacio de nombres:Microsoft.VisualBasic.MyServices
Clase:FileSystemProxy (proporciona acceso a FileSystem)
Ensamblado: biblioteca en tiempo de ejecución de Visual Basic (en Microsoft.VisualBasic.dll)
Disponibilidad por tipo de proyecto
Tipo de proyecto |
Disponible |
---|---|
Aplicación para Windows |
Sí |
Biblioteca de clases |
Sí |
Aplicación de consola |
Sí |
Biblioteca de controles de Windows |
Sí |
Biblioteca de controles Web |
Sí |
Servicio de Windows |
Sí |
Sitio Web |
Sí |
Permisos
Los permisos siguientes pueden ser necesarios:
Permiso |
Descripción |
---|---|
Controla la capacidad de tener acceso a archivos y carpetas. Enumeración asociada: Unrestricted. |
|
Describe un conjunto de permisos de seguridad aplicados al código. Enumeración asociada: ControlEvidence. |
Para obtener más información, vea Seguridad de acceso a código y Solicitar permisos.
Vea también
Tareas
Cómo: Leer archivos de texto en Visual Basic
Cómo: Leer archivos de texto delimitado por comas en Visual Basic
Cómo: Leer archivos de texto con varios formatos en Visual Basic
Conceptos
Analizar archivos de texto con el objeto TextFieldParser
Referencia
My.Computer.FileSystem (Objeto)