UrlMappingCollection.Clear Yöntem

Tanım

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

Koleksiyondaki UrlMapping 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, içindeki tüm UrlMapping nesneleri UrlMappingCollectionkaldırır.

Koleksiyonu nasıl edineceğinizi öğrenmek için sınıf konusunun kod örneğine UrlMappingCollection bakın.


// Clear the url mapping collection.
urlMappings.Clear();

// Update the configuration file.

// Define the save modality.
ConfigurationSaveMode saveMode =
  ConfigurationSaveMode.Minimal;

urlMappings.EmitClear =
   Convert.ToBoolean(parm2);

if (parm1 == "none")
{
  if (!urlMappingSection.IsReadOnly())
    configuration.Save();
  msg = String.Format(
  "Default modality, EmitClear:      {0}",
  urlMappings.EmitClear.ToString());
}
else
{
  if (parm1 == "full")
    saveMode = ConfigurationSaveMode.Full;
  else
    if (parm1 == "modified")
      saveMode = ConfigurationSaveMode.Modified;

  if (!urlMappingSection.IsReadOnly())
    configuration.Save(saveMode);

  msg = String.Format(
   "Save modality:      {0}",
   saveMode.ToString());
}

' Clear the url mapping collection.
urlMappings.Clear()

' Update the configuration file.
' Define the save modality.
Dim saveMode _
As ConfigurationSaveMode = _
ConfigurationSaveMode.Minimal

urlMappings.EmitClear = _
Convert.ToBoolean(parm2)

If parm1 = "none" Then
    If Not urlMappingSection.IsReadOnly() Then
        configuration.Save()
    End If
    msg = String.Format( _
    "Default modality, EmitClear:      {0}", _
    urlMappings.EmitClear.ToString())
Else
    If parm1 = "full" Then
        saveMode = ConfigurationSaveMode.Full
    ElseIf parm1 = "modified" Then
        saveMode = ConfigurationSaveMode.Modified
    End If
    If Not urlMappingSection.IsReadOnly() Then
        configuration.Save(saveMode)
    End If
    msg = String.Format( _
    "Save modality:      {0}", _
    saveMode.ToString())
End If

Açıklamalar

yöntemini çağırdıktan Clear sonra yapılandırma dosyasını kaydederseniz, sonuç seçilen ConfigurationSaveModeöğesine bağımlı olur.

Aşağıdaki listede, dosyayı kaydetmek için yöntemini kullanırsanız Save geçerli olan koşullar açıklanmaktadır:

  • parametre değeri olarak veya Full geçirirsenizConfigurationSaveMode.Modified, geçerli hiyerarşi düzeyinde yapılandırma dosyasının bölümüne bir clear öğe eklenirurlMappings.

  • Parametre değeri olarak geçirirseniz Minimal , geçerli hiyerarşi düzeyinde yapılandırma dosyasının öğesine bir dizi remove öğe eklenir urlMappings . Bu remove öğeler, 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, koleksiyonda yapılandırma dosyasında seri hale getirilenleri etkileyen ek bir özellik vardır. özelliği EmitClear varsayılan olarak ve şeklindedir false . Aşağıdaki koşullardan biri geçerlidir:

    • EmitClear olarak trueayarlayın. clear Geçerli hiyerarşi düzeyinde yapılandırma dosyasının bölümüne bir öğe eklenirurlMappings. 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 bayrağı olarak falseayarlanır. Bu, varsa geçerli hiyerarşi düzeyinde yapılandırma dosyasının bölümünden öğesini clear kaldırma urlMappings etkisine sahiptir.

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 silerurlMappings. 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, ancak bunları silmez.

Şunlara uygulanır

Ayrıca bkz.