ParserErrorCollection 類別

定義

public ref class ParserErrorCollection sealed : System::Collections::CollectionBase

[System.Serializable]
public sealed class ParserErrorCollection : System.Collections.CollectionBase

[<System.Serializable>]
type ParserErrorCollection = class
    inherit CollectionBase

Public NotInheritable Class ParserErrorCollection
Inherits CollectionBase

繼承

Object

CollectionBase

ParserErrorCollection

屬性

SerializableAttribute

範例

以下程式碼範例示範如何使用這些 ParserErrorCollection 方法。

// 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);

' 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)

備註

這個 ParserErrorCollection 類別提供了你可以用來管理一組 ParserError 物件的方法和屬性。 例如，你可以在解析時加入一組解析器錯誤，同時使用自訂 BuildProvider 物件回報解析中捕捉到的所有解析異常。

要在集合中新增、移除或定位解析器錯誤，請使用以下工具：

• 將 Add 單一 ParserError 物件加入集合的方法。

• 新增 AddRange 多個 ParserError 物件到集合的方法。

• 同時使用Insert方法與Item[]ParserErrorCollection屬性（索引器）在指定索引處將單一ParserError物件加入集合。

此外，你也可以利用這 ParserErrorCollection 門課做以下事情：

• 用這個ParserError方法移除Remove物品。

• 使用該ParserError方法檢查某個特定Contains對象是否在該集合中。

• 透過使用此ParserError方法找出物件在集合中的位置IndexOf。

另請參閱

• BuildProvider
• HttpException