Ensamblado: System.Xml (en system.xml.dll)
Public Overridable Function ReadValueChunk ( _ buffer As Char(), _ index As Integer, _ count As Integer _ ) As Integer
Dim instance As XmlReader Dim buffer As Char() Dim index As Integer Dim count As Integer Dim returnValue As Integer returnValue = instance.ReadValueChunk(buffer, index, count)
public virtual int ReadValueChunk ( char[] buffer, int index, int count )
public: virtual int ReadValueChunk ( array<wchar_t>^ buffer, int index, int count )
public int ReadValueChunk ( char[] buffer, int index, int count )
public function ReadValueChunk ( buffer : char[], index : int, count : int ) : int
No aplicable.
Parámetros
- buffer
-
Matriz de caracteres que sirve como búfer en el que se escribe el contenido de texto. Este valor no puede ser referencia null (Nothing en Visual Basic).
- index
-
Desplazamiento en el búfer en el que XmlReader puede empezar a copiar los resultados.
- count
-
Número máximo de caracteres que se van a copiar en el búfer. El número real de caracteres copiados se devuelve desde este método.
Valor devuelto
Número de caracteres leídos en el búfer. Si no hay más contenido de texto, se devuelve el valor cero.| Tipo de excepción | Condición |
|---|---|
| El nodo actual no tiene ningún valor (HasValue es false). |
|
| El valor de buffer es referencia null (Nothing en Visual Basic). |
|
| El índice del búfer (index) o la suma del índice y el recuento (index + count) es mayor que el tamaño de búfer asignado. |
|
| La implementación de XmlReader no admite este método. |
|
| El formato de los datos XML no es correcto. |
Este método habilita la lectura de secuencias muy grandes de texto incrustadas en un documento XML en un modo de transmisión; es decir, un número de caracteres pequeño a la vez en lugar de asignar una cadena única a todo el valor. Se puede llamar a este método en cualquier nodo que tenga un valor (HasValue es true); sin embargo, la verdadera transmisión del valor del nodo sólo se produce cuando la llamada se realiza en nodos de texto, espacio en blanco y espacio en blanco significativo. Los demás valores de tipo nodo se almacenan en la memoria caché, incluidos los atributos y los nodos CDATA.
Este método devuelve sólo el contenido de la propiedad Value y no mueve el objeto XmlReader.
Este método lee el número de caracteres especificado (count) del valor del nodo en un búfer de caracteres (buffer) con un desplazamiento especificado (index) y devuelve el número de caracteres escrito en el búfer. Devuelve 0 cuando se llega al final del valor. No se puede reiniciar para volver a leer el valor.
Entre las llamadas al método ReadValueChunk, no se produce ningún cambio en las propiedades de XmlReader, excepto en la propiedad Value. Cuando se obtiene acceso a la propiedad Value, puede devolver un valor parcial (con caracteres que no aún no haya devuelto el método ReadValueChunk) o un valor completo dependiendo de la implementación. Todas las implementaciones del objeto XmlReader en el espacio de nombres System.Xml devuelven un valor parcial para la implementación de la propiedad Value.
Entre las llamadas al método ReadValueChunk, se puede llamar a cualquier método del tipo Read. Si esto ocurre, el objeto XmlReader se desplaza al siguiente XmlNodeType de la secuencia y se omiten todos los caracteres que aún no se hayan devuelto.
Se puede dar este caso cuando el método ReadValueChunk devuelve un número de caracteres inferior al solicitado. Por ejemplo, si hay un valor de 200 caracteres con un par suplente en las posiciones 127 y 128 y llama al método ReadValueChunk con un búfer de 128 caracteres, la llamada al método devolverá 127 caracteres en lugar de los 128 solicitados. El par suplente se devolvería a continuación en la siguiente llamada al método ReadValueChunk. En este caso, el método ReadValueChunk no devolvió los 128 caracteres solicitados, ya que con ello se podría haber creado un par suplente incompleto al final del búfer.
Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter
Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.