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 UrlMappingCollection kod örneğine 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 ConfigurationSaveMode.Modified geçirirsenizFull, 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 bir ek özellik vardır. özelliği EmitClear varsayılan olarak ve şeklindedir false . Aşağıdaki koşullardan biri geçerlidir:

  • EmitClear olarak trueayarlayın. Geçerli hiyerarşi düzeyinde yapılandırma dosyasının bölümüne bir clear öğe eklenir urlMappings . Bu, hiyerarşideki add ü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 urlMappings kaldırma clear etkisine sahiptir.

Clear yöntemi aslında geçerli hiyerarşi düzeyinde yapılandırma dosyasının urlMappings bölümünde tanımlanan öğeleri sileradd. Ayrıca hiyerarşide add üst yapılandırma dosyalarında tanımlanan öğelere yapılan tüm başvuruları kaldırır, ancak bunları silmez.

Ayrıca bkz.

• UrlMapping
• UrlMappingsSection