XmlReaderSettings.MaxCharactersInDocument プロパティ
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
XML ドキュメントの最大文字数を示す値を取得または設定します。 ゼロ (0) の値は、XML ドキュメントのサイズに制限がないことを示します。 0 以外の値は、最大サイズを文字数で示します。
public:
property long MaxCharactersInDocument { long get(); void set(long value); };C#
public long MaxCharactersInDocument { get; set; }member this.MaxCharactersInDocument : int64 with get, setPublic Property MaxCharactersInDocument As LongXML ドキュメント内の最大文字数。 既定値は 0 です。
次のコードでは、このプロパティを設定し、制限を超えるドキュメントの解析を試みます。 実際のシナリオでは、この制限を有効なドキュメントを処理するのに十分な大きさに設定しますが、悪意のあるドキュメントからの脅威を制限するのに十分な小さい値に設定します。
C#
string markup = "<Root>Content</Root>";
XmlReaderSettings settings = new XmlReaderSettings();
settings.MaxCharactersInDocument = 10;
try
{
XmlReader reader = XmlReader.Create(new StringReader(markup), settings);
while (reader.Read()) { }
}
catch (XmlException ex)
{
Console.WriteLine(ex.Message);
}
Dim markup As String = "<Root>Content</Root>"
Dim settings As XmlReaderSettings = New XmlReaderSettings()
settings.MaxCharactersInDocument = 10
Try
Dim reader As XmlReader = XmlReader.Create(New StringReader(markup), settings)
While (reader.Read())
End While
Catch ex As XmlException
Console.WriteLine(ex.Message)
End Try
このコードを実行すると、次の出力が生成されます。
There is an error in XML document (MaxCharactersInDocument, ).
ゼロ (0) の値は、解析されたドキュメント内の文字数に制限がないことを意味します。 0 以外の値は、解析できる最大文字数を指定します。
ドキュメントの最大文字数には、展開されたエンティティの結果の文字数が含まれます。
リーダーがこのプロパティを超えるサイズのドキュメントを読み取ろうとすると、スロー XmlException されます。
このプロパティを使用すると、攻撃者が非常に大きな XML ドキュメントを送信するサービス拒否攻撃を軽減できます。 ドキュメントのサイズを制限することで、攻撃を検出し、確実に回復できます。
| 製品 | バージョン |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |