ClientTargetCollection.Clear Metoda

Definicja

Przestrzeń nazw:

System.Web.Configuration

Zestaw:

System.Web.dll

Usuwa wszystkie ClientTarget 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 ClientTarget obiekty z kolekcji ClientTargetCollection .

Aby uzyskać informacje o sposobie pobierania kolekcji, zobacz przykładowy kod w omówieniu ClientTargetCollection klasy.

           // Clear the client target collection.
           clientTargets.Clear();

           // Update the configuration file.
           if (!clientTargetSection.IsReadOnly())
             configuration.Save();

' Clear the client target collection.
clientTargets.Clear()

' Update the configuration file.
If Not clientTargetSection.IsReadOnly() Then
    configuration.Save()
End If

Uwagi

Wynik aktualizacji pliku konfiguracji po wywołaniu Clear metody jest zależny od wybranej ConfigurationSaveMode wartości. Aby zaktualizować plik konfiguracji, użyj jednej z następujących dwóch metod: Configuration.Save lub Configuration.Save.

Uwaga

Wywołanie Configuration.Save jest równoważne wywołaniu Save podczas modyfikowania ConfigurationSaveMode wartości.

Jeśli używasz Configuration.Save metody , 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 Minimalremove do sekcji pliku konfiguracji na bieżącym poziomie hierarchii zostanie dodana clientTarget seria elementów. Spowoduje to usunięcie wszystkich odwołań do add elementów zdefiniowanych w plikach konfiguracji nadrzędnej na wyższych poziomach w hierarchii. W przypadku Minimal wartości wyliczenia jedna dodatkowa właściwość w kolekcji wpływa na to, co jest serializowane w pliku konfiguracji. Właściwość jest EmitClear domyślnie i .false Ma zastosowanie jeden z następujących warunków:

  • Gdy EmitClear jest ustawiona wartość true, clear element jest wstawiany 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.

  • Gdy EmitClear jest ustawiona wartość 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 add elementów 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.

Zobacz też

• ClientTarget
• ClientTargetSection