CustomErrorCollection.Clear Metoda

public:
 void Clear();

public void Clear();

member this.Clear : unit -> unit

Public Sub Clear ()

Przykłady

Poniższy przykład kodu usuwa wszystkie CustomError obiekty z kolekcji CustomErrorCollection . Zapoznaj się z przykładem kodu w temacie CustomErrorCollection klasy, aby dowiedzieć się, jak uzyskać kolekcję.

// Using the Clear method.
if (!customErrorsSection.SectionInformation.IsLocked)
{
    // Execute the Clear method.
    customErrorsCollection.Clear();
    configuration.Save();
}

' Using the Clear method.
If Not customErrorsSection.SectionInformation.IsLocked Then
   ' Execute the Clear method.
   customErrorsCollection.Clear()
   configuration.Save()
End If

Uwagi

Wynik aktualizacji pliku konfiguracji po wywołaniu Clear metody jest zależny od wybranej ConfigurationSaveMode metody. Aby zaktualizować plik konfiguracji, należy użyć jednego z tych dwóch przeciążeń: Save i Save.

Jeśli używasz Savemetody ., obowiązują następujące warunki.

• Jeśli przekażesz wartość parametru Full lub Modified , clear element zostanie wstawiony do clientTarget sekcji pliku konfiguracji na bieżącym poziomie hierarchii.

• W przypadku przekazania wartości parametru Minimal serii elementów remove są dodawane do elementu clientTarget (schemat ustawień ASP.NET) pliku konfiguracji na bieżącym poziomie hierarchii. Każda z nich usuwa wszystkie odwołania do elementu zdefiniowanego add w pliku konfiguracji nadrzędnej na wyższym poziomie w hierarchii. W przypadku korzystania z programu Minimalistnieje jedna dodatkowa właściwość w kolekcji, która ma wpływ na to, co jest serializowane do pliku konfiguracji: EmitClear, który jest false domyślnie. Obowiązują następujące warunki.

  • Jeśli ustawiono EmitClear wartość true, clear element zostanie wstawiony do clientTarget sekcji pliku konfiguracji na bieżącym poziomie hierarchii. Spowoduje to usunięcie wszystkich odwołań do add elementów zdefiniowanych w plikach konfiguracji nadrzędnej na wyższych poziomach w hierarchii.

  • Jeśli flaga EmitClear jest ustawiona na false, clear element zostanie usunięty z clientTarget sekcji pliku konfiguracji na bieżącym poziomie hierarchii, jeśli istnieje.

Metoda Clear faktycznie usuwa add elementy zdefiniowane w clientTarget sekcji pliku konfiguracji na bieżącym poziomie hierarchii. Usuwa również wszystkie odwołania do dodawania elementów zdefiniowanych w plikach konfiguracji nadrzędnej na wyższych poziomach w hierarchii.