UrlMappingCollection.Clear メソッド

定義

名前空間:

System.Web.Configuration

アセンブリ:

System.Web.dll

すべての UrlMapping オブジェクトをコレクションから削除します。

public:
 void Clear();

public void Clear ();

member this.Clear : unit -> unit

Public Sub Clear ()

例

次のコード例では、すべての UrlMapping オブジェクトを UrlMappingCollection.

コレクションを取得する方法については、クラス トピックの UrlMappingCollection コード例を参照してください。

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

注釈

メソッドの呼び出し後に構成ファイルを Clear 保存した場合、結果は選択した ConfigurationSaveMode内容に依存します。

次の一覧では、メソッドを使用してファイルを保存する場合に Save 適用される条件について説明します。

• パラメーター値として渡すか、パラメーターConfigurationSaveMode.Modified値として渡Fullすと、clear現在の階層レベルの構成ファイルのセクションにurlMappings要素が挿入されます。

• パラメーター値として渡 Minimal すと、一連の remove 要素が現在の階層レベルの構成ファイルに追加 urlMappings されます。 これらの要素は remove 、階層内の add 上位レベルの親構成ファイルで定義されている要素への参照をすべて削除します。 列挙値を Minimal 使用すると、構成ファイルにシリアル化される内容に影響を与えるプロパティがコレクションに 1 つ追加されます。 このプロパティは EmitClear 、既定で使用 false されます。 次のいずれかの条件が適用されます。

  • EmitClear に設定します true。 clear要素は、現在のurlMappings階層レベルの構成ファイルのセクションに挿入されます。 これにより、階層内の add 上位レベルの親構成ファイルで定義されている要素への参照がすべて削除されます。

  • EmitClear フラグが に false設定されています。 これは、現在の階層レベルの構成ファイルのセクションからurlMappings要素が存在する場合に削除clearする効果があります。

このメソッドは Clear 、現在の add 階層レベルで構成ファイルのセクションで urlMappings 定義されている要素を実際に削除します。 また、階層内の add 上位レベルの親構成ファイルで定義されている要素への参照もすべて削除されますが、削除されません。

こちらもご覧ください

• UrlMapping
• UrlMappingsSection