ClientTargetCollection.Clear Yöntem

Tanım

Ad Alanı:
System.Web.Configuration
Bütünleştirilmiş Kod:
System.Web.dll

Koleksiyondaki ClientTarget tüm nesneleri kaldırır.

public:
 void Clear();
public void Clear();
member this.Clear : unit -> unit
Public Sub Clear ()

Örnekler

Aşağıdaki kod örneği koleksiyondaki ClientTargetClientTargetCollection tüm nesneleri kaldırır.

Koleksiyonu alma hakkında bilgi için sınıfa genel bakış bölümünde kod örneğine ClientTargetCollection bakın.


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

Açıklamalar

yöntemi çağrıldıktan sonra yapılandırma dosyasını güncelleştirmenin Clear sonucu, seçilen değere ConfigurationSaveMode bağlıdır. Yapılandırma dosyasını güncelleştirmek için şu iki yöntemden birini kullanırsınız: Configuration.Save veya Configuration.Save.

Note

Çağırma Configuration.Save , değer değiştirildiğinde çağrılmaya SaveConfigurationSaveMode eşdeğerdir.

yöntemini kullanırsanız Configuration.Save , aşağıdaki koşullar geçerlidir:

  • veya Full parametre değerini geçirirsenizModified, yapılandırma dosyasının clear geçerli hiyerarşi düzeyindeki bölümüne bir clientTarget öğe eklenir.

  • Parametre değerini geçirirseniz, yapılandırma dosyasının Minimalremove geçerli hiyerarşi düzeyindeki bölümüne bir dizi öğe eklenir clientTarget . Bu, hiyerarşideki add daha yüksek düzeylerde üst yapılandırma dosyalarında tanımlanan öğelere yapılan tüm başvuruları kaldırır. Minimal Numaralandırma değeriyle, koleksiyondaki ek bir özellik yapılandırma dosyasında seri hale getirilenleri etkiler. özelliği EmitClear varsayılan olarak ve şeklindedir false . Aşağıdaki koşullardan biri geçerlidir:

    • EmitClear olarak ayarlandığındatrue, geçerli hiyerarşi düzeyinde yapılandırma dosyasının bölümüne bir clear öğe eklenirclientTarget. Bu, hiyerarşideki add daha yüksek düzeylerde üst yapılandırma dosyalarında tanımlanan öğelere yapılan tüm başvuruları kaldırır.

    • EmitClear olarak ayarlandığındafalseclear, öğe varsa geçerli hiyerarşi düzeyinde yapılandırma dosyasının bölümünden kaldırılırclientTarget.

Clear yöntemi aslında geçerli hiyerarşi düzeyinde yapılandırma dosyasının add bölümünde tanımlanan öğeleri silerclientTarget. Ayrıca hiyerarşideki add daha yüksek düzeylerde üst yapılandırma dosyalarında tanımlanan öğelere yapılan tüm başvuruları kaldırır.

Note

Öğeler add üst yapılandırma dosyalarının clientTarget bölümünden silinmez.

Şunlara uygulanır

Ayrıca bkz.