INameCreationService.CreateName メソッド

.NET Framework クラス ライブラリ リファレンス

INameCreationService.CreateName メソッド

指定したコンテナ内でどのコンポーネントとも重複しない新しい名前を作成します。

名前空間: System.ComponentModel.Design.Serialization
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Function CreateName ( _
    container As IContainer, _
    dataType As Type _
) As String

Visual Basic (使用法)

Dim instance As INameCreationService
Dim container As IContainer
Dim dataType As Type
Dim returnValue As String

returnValue = instance.CreateName(container, dataType)

C#

string CreateName (
    IContainer container,
    Type dataType
)

C++

String^ CreateName (
    IContainer^ container, 
    Type^ dataType
)

J#

String CreateName (
    IContainer container, 
    Type dataType
)

JScript

function CreateName (
    container : IContainer, 
    dataType : Type
) : String

パラメータ

container

新しいオブジェクトが追加される先のコンテナ。

dataType

名前を受け取るオブジェクトのデータ型。

戻り値
データ型の一意の名前。

解説

このメソッドは、指定したコンテナ内で重複しない新しいオブジェクトの名前を返します。

実装時の注意 この種類のサービスは、データ型の名前から一意のオブジェクト名を作成するために実装されることがあります。これには、名前を一意の識別子にするための番号が追加される場合があります。たとえば、ListBox オブジェクトでは ListBox1 のようになります。

使用例

INameCreationService.CreateName メソッドを実装するコード例を次に示します。このメソッドでは、指定したコンテナ内のコンポーネント名に対して一意な名前を、指定した種類で作成できます。

Visual Basic

' Creates an identifier for a particular data type that does not conflict
 
' with the identifiers of any components in the specified collection
Public Function CreateName(ByVal
 container As System.ComponentModel.IContainer, ByVal
 dataType As System.Type) As String Implements INameCreationService.CreateName
    ' Create a basic type name string
    Dim baseName As String
 = dataType.Name
    Dim uniqueID As Integer
 = 1

    Dim unique As Boolean
 = False
    ' Continue to increment uniqueID numeral until a unique ID is located.
    While Not unique
        unique = True
        ' Check each component in the container for a matching 
        ' base type name and unique ID.
        Dim i As Integer
        For i = 0 To container.Components.Count
 - 1
            ' Check component name for match with unique ID string.
            If container.Components(i).Site.Name.StartsWith((baseName
 + uniqueID.ToString())) Then
                ' If a match is encountered, set flag to recycle 
                ' collection, increment ID numeral, and restart.
                unique = False
                uniqueID += 1
                Exit For
            End If
        Next i
    End While

    Return baseName + uniqueID.ToString()
End Function

C#

// Creates an identifier for a particular data type that does not conflict
 
// with the identifiers of any components in the specified collection.
public string CreateName(System.ComponentModel.IContainer
 container, System.Type dataType)
{
    // Create a basic type name string.
    string baseName = dataType.Name;
    int uniqueID = 1;

    bool unique = false;            
    // Continue to increment uniqueID numeral until a 
    // unique ID is located.
    while( !unique )
    {
        unique = true;
        // Check each component in the container for a matching 
        // base type name and unique ID.
        for(int i=0; i<container.Components.Count;
 i++)
        {
            // Check component name for match with unique ID string.
            if( container.Components[i].Site.Name.StartsWith(baseName+uniqueID.ToString())
 )
            {
                // If a match is encountered, set flag to recycle 
                // collection, increment ID numeral, and restart.
                unique = false;
                uniqueID++;
                break;
            }
        }
    }
    
    return baseName+uniqueID.ToString();
}

C++

// Creates an identifier for a particular data type that does not conflict
 
// with the identifiers of any components in the specified collection.
virtual String^ CreateName( System::ComponentModel::IContainer^ container, System::Type^
 dataType )
{
   // Create a basic type name string.
   String^ baseName = dataType->Name;
   int uniqueID = 1;
   bool unique = false;

   // Continue to increment uniqueID numeral until a 
   // unique ID is located.
   while (  !unique )
   {
      unique = true;

      // Check each component in the container for a matching 
      // base type name and unique ID.
      for ( int i = 0; i < container->Components->Count;
 i++ )
      {
         // Check component name for match with unique ID string.
         if ( container->Components[ i ]->Site->Name->StartsWith(
 String::Concat( baseName, uniqueID ) ) )
         {
            // If a match is encountered, set flag to recycle 
            // collection, increment ID numeral, and restart.
            unique = false;
            uniqueID++;
            break;
         }
      }
   }

   return String::Concat( baseName, uniqueID );
}

J#

// Creates an identifier for a particular data type that does not conflict
 
// with the identifiers of any components in the specified collection.
public String CreateName(System.ComponentModel.IContainer container,
 
    System.Type dataType)
{
    // Create a basic type name string.
    String baseName = dataType.get_Name();
    int uniqueID = 1;
    boolean unique = false;

    // Continue to increment uniqueID numeral until a 
    // unique ID is located.
    while (!(unique)) {
        unique = true;

        // Check each component in the container for a matching 
        // base type name and unique ID.
        for (int i = 0; i < container.get_Components().get_Count();
 i++) {
            // Check component name for match with unique ID string.
            if (container.get_Components().get_Item(i).get_Site().
                get_Name().StartsWith((baseName + ((Int32)uniqueID).
                ToString()))) {
                // If a match is encountered, set flag to recycle 
                // collection, increment ID numeral, and restart.
                unique = false;
                uniqueID++;
                break;
            }
        }
    }
    return (baseName + ((Int32)uniqueID).ToString());
} //CreateName

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
INameCreationService インターフェイス
INameCreationService メンバ
System.ComponentModel.Design.Serialization 名前空間