XmlDictionaryReaderQuotas.MaxBytesPerRead Eigenschaft

Definition

Namespace:

System.Xml

Assembly:

System.Runtime.Serialization.Xml.dll

Source:

XmlDictionaryReaderQuotas.cs

Ruft die bei jedem Lesevorgang zurückgegebenen maximal zulässigen Bytes ab oder legt sie fest.

public:
 property int MaxBytesPerRead { int get(); void set(int value); };

public int MaxBytesPerRead { get; set; }

member this.MaxBytesPerRead : int with get, set

Public Property MaxBytesPerRead As Integer

Eigenschaftswert

Int32

Die maximal zulässigen Bytes, die bei jedem Lesevorgang zurückgegeben werden. Der Standardwert lautet 4096.

Ausnahmen

InvalidOperationException

Mit set wird versucht, den Wert festzulegen, aber Kontingentwerte sind für diese Instanz schreibgeschützt.

ArgumentException

Mit set wird versucht, den Wert auf einen kleineren Wert als 0 (null) festzulegen.

Hinweise

Dieses Kontingent beschränkt die Anzahl der Bytes, die vom Reader während eines einzelnen Read()-Aufrufs in Anspruch genommen werden können.

Dieses Kontingent ist nur eine ungefähre Angabe, da vor der Anwendung dieses Kontingents Transformationen auf Codierungsebene durchgeführt werden. Dieses Kontingent ist eng mit der Anzahl der Bytes verbunden, die auf Transportebene empfangen werden, sein Zweck besteht jedoch darin, die Menge der bei jedem Lesevorgang empfangenen Daten zu steuern. In der Praxis wird es verwendet, um die Größe von Starttags einzuschränken. Da für die Verarbeitung das gesamte Starttag gepuffert werden muss (die Eindeutigkeit der Attribute muss überprüft werden), muss die Größe zur Abschwächung von DOS-Angriffen eingeschränkt werden.

Mit dem öffentlichen Konstruktor erstellte Instanzen verfügen über Eigenschaften, die mit set festgelegt werden können.