CustomErrorCollection.Clear Metoda

Definicja

Przestrzeń nazw:

System.Web.Configuration

Zestaw:

System.Web.dll

Usuwa wszystkie CustomError obiekty z kolekcji.

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 pobrać 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.

Uwaga

Wywołanie Save jest równoważne wywołaniu metody Save.

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

• W przypadku przekazania wartości parametru Full lub Modified element zostanie wstawiony do clientTarget sekcji pliku konfiguracji na clear bieżącym poziomie hierarchii.

• Jeśli przekażesz wartość parametruMinimal, do elementu clientTarget (ASP.NET schematu ustawień) pliku konfiguracji na bieżącym poziomie hierarchii zostaną dodane serie remove elementów. 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 wpływa na serializację pliku konfiguracji: EmitClear, która jest false domyślnie. Obowiązują następujące warunki.

  • EmitClear Jeśli zestaw ma truewartość , 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 elementów dodanych zdefiniowanych w plikach konfiguracji nadrzędnej na wyższych poziomach w hierarchii.

Uwaga

add Elementy nie są usuwane z clientTarget sekcji plików konfiguracji nadrzędnej.