ParserErrorCollection クラス

.NET Framework クラス ライブラリ リファレンス

ParserErrorCollection クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

解析中に検出される一連のパーサー エラーを管理します。このクラスは継承できません。

名前空間: System.Web
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
Public NotInheritable Class
 ParserErrorCollection
    Inherits CollectionBase

Visual Basic (使用法)

Dim instance As ParserErrorCollection

C#

[SerializableAttribute] 
public sealed class ParserErrorCollection :
 CollectionBase

C++

[SerializableAttribute] 
public ref class ParserErrorCollection sealed
 : public CollectionBase

J#

/** @attribute SerializableAttribute() */ 
public final class ParserErrorCollection extends
 CollectionBase

JScript

SerializableAttribute 
public final class ParserErrorCollection extends
 CollectionBase

解説

ParserErrorCollection クラスは、ParserError オブジェクトのコレクションを管理するために使用できるメソッドとプロパティを提供します。たとえば、解析時に、カスタムの BuildProvider オブジェクトを使用して解析中にキャッチされるすべての解析例外を報告すると同時に、一連のパーサー エラーをコレクションに追加できます。

コレクションのパーサー エラーを追加、削除、または検索するには、次の方法を使用します。

• Add メソッドを使用して、1 つの ParserError をコレクションに追加します。

• AddRange メソッドを使用して、複数の ParserError オブジェクトをコレクションに追加します。

• Insert メソッドと、ParserErrorCollection のインデクサである Item プロパティの両方を使用して、1 つの ParserError オブジェクトをコレクションの指定したインデックス位置に追加します。

さらに、ParserErrorCollection クラスを使用して、次の操作を行うことができます。

• Remove メソッドを使用して、ParserError オブジェクトを削除します。

• Contains メソッドを使用して、特定の ParserError がコレクション内にあるかどうかを確認します。

• IndexOf メソッドを使用して、コレクション内での ParserError オブジェクトの位置を確認します。

使用例

ParserErrorCollection メソッドを使用する方法を次のコード例に示します。

Visual Basic

' Create an empty ParserErrorCollection.
Dim collection As New ParserErrorCollection()

' Add a ParserError to the collection.
collection.Add(New ParserError("ErrorName",
 "Path", 1))

' Add an array of ParserError objects to the collection.
Dim errors As ParserError() = _
    {New ParserError("Error 2", "Path",
 1), _
    New ParserError("Error 3",
 "Path", 1)}
collection.AddRange(errors)

' Ads a collection of ParserError objects to the collection.
Dim errorsCollection As New
 ParserErrorCollection()
errorsCollection.Add(New ParserError("Error",
 "Path", 1))
errorsCollection.Add(New ParserError("Error",
 "Path", 1))
collection.AddRange(errorsCollection)

' Test for the presence of a ParserError in the 
' collection, and retrieve its index if it is found.
Dim testError As New ParserError("Error",
 "Path", 1)
Dim itemIndex As Integer
 = -1
If collection.Contains(testError) Then
  itemIndex = collection.IndexOf(testError)
End If

' Copy the contents of the collection to a
' compatible array, starting at index 0 of the
' destination array. 
Dim errorsToSort(5) As ParserError
collection.CopyTo(errorsToSort, 0)

' Retrieve the count of the items in the collection.
Dim collectionCount As Integer
 = collection.Count

' Insert a ParserError at index 0 of the collection.
Dim [error] As New ParserError("Error",
 "Path", 1)
collection.Insert(0, [error])

' Remove the specified ParserError from the collection.
collection.Remove([error])

' Remove the ParserError at index 0.
collection.RemoveAt(0)

C#

// Create an empty ParserErrorCollection.
ParserErrorCollection collection = new ParserErrorCollection();

// Add a ParserError to the collection.
collection.Add(new ParserError("ErrorName", "Path",
 1));

// Add an array of ParserError objects to the collection.
ParserError[] errors = 
    { new ParserError("Error 2", "Path", 1),
 
    new ParserError("Error 3", "Path", 1)
 };
collection.AddRange(errors);

// Add a collection of ParserError objects to the collection.
ParserErrorCollection errorsCollection = new ParserErrorCollection();
errorsCollection.Add(new ParserError("Error", "Path",
 1));
errorsCollection.Add(new ParserError("Error", "Path",
 1));
collection.AddRange(errorsCollection);

// Test for the presence of a ParserError in the 
// collection, and retrieve its index if it is found.
ParserError testError = new ParserError("Error", "Path",
 1);
int itemIndex = -1;
if (collection.Contains(testError))
  itemIndex = collection.IndexOf(testError);

// Copy the contents of the collection to a
// compatible array, starting at index 0 of the
// destination array. 
ParserError[] errorsToSort = new ParserError[5];
collection.CopyTo(errorsToSort, 0);

// Retrieve the count of the items in the collection.
int collectionCount = collection.Count;

// Insert a ParserError at index 0 of the collection.
ParserError error = new ParserError("Error", "Path",
 1);
collection.Insert(0, error);

// Remove the specified ParserError from the collection.
collection.Remove(error);

// Remove the ParserError at index 0.
collection.RemoveAt(0);

継承階層

System.Object
   System.Collections.CollectionBase
    System.Web.ParserErrorCollection

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ParserErrorCollection メンバ
System.Web 名前空間
BuildProvider
HttpException クラス