RoleProvider.CreateRole(String) メソッド

定義

名前空間:

System.Web.Security

アセンブリ:

System.Web.ApplicationServices.dll

構成された applicationName のデータ ソースに新しいロールを追加します。

public:
 abstract void CreateRole(System::String ^ roleName);

public abstract void CreateRole (string roleName);

abstract member CreateRole : string -> unit

Public MustOverride Sub CreateRole (roleName As String)

パラメーター

roleName

String

作成するロールの名前。

例

次のコード例は、 メソッドの実装例を CreateRole 示しています。

public override void CreateRole(string rolename)
{ 
  if (rolename == null || rolename == "")
    throw new ProviderException("Role name cannot be empty or null.");
  if (rolename.Contains(","))
    throw new ArgumentException("Role names cannot contain commas.");
  if (RoleExists(rolename))
    throw new ProviderException("Role name already exists.");
  if (rolename.Length > 255)
    throw new ProviderException("Role name cannot exceed 255 characters.");

  OdbcConnection conn = new OdbcConnection(connectionString);
  OdbcCommand cmd = new OdbcCommand("INSERT INTO Roles "  +
                                    " (Rolename, ApplicationName) " +
                                    " Values(?, ?)", conn);

  cmd.Parameters.Add("@Rolename", OdbcType.VarChar, 255).Value = rolename;
  cmd.Parameters.Add("@ApplicationName", OdbcType.VarChar, 255).Value = ApplicationName;

  try
  {
    conn.Open();

    cmd.ExecuteNonQuery();
  }
  catch (OdbcException)
  {
    // Handle exception.
  }
  finally
  {
    conn.Close();      
  }
}

Public Overrides Sub CreateRole(rolename As String) 
  If rolename Is Nothing OrElse rolename = "" Then _
    Throw New ProviderException("Role name cannot be empty or null.")
  If rolename.Contains(",") Then _
    Throw New ArgumentException("Role names cannot contain commas.")
  If RoleExists(rolename) Then _
    Throw New ProviderException("Role name already exists.")
  If rolename.Length > 255 Then _
    Throw New ProviderException("Role name cannot exceed 255 characters.")

  Dim conn As OdbcConnection = New OdbcConnection(connectionString)
            Dim cmd As OdbcCommand = New OdbcCommand("INSERT INTO Roles " & _
                                                     " (Rolename, ApplicationName) " & _
                                                     " Values(?, ?)", conn)

            cmd.Parameters.Add("@Rolename", OdbcType.VarChar, 255).Value = rolename
            cmd.Parameters.Add("@ApplicationName", OdbcType.VarChar, 255).Value = ApplicationName

            Try
                conn.Open()

                cmd.ExecuteNonQuery()
            Catch e As OdbcException
                ' Handle exception.
            Finally
                conn.Close()
            End Try
        End Sub

注釈

CreateRole は、 クラスの CreateRoleRoles メソッドによって呼び出され、構成された ApplicationNameのデータ ソースに指定されたロールを追加します。

指定したロール名が、構成済 applicationNameみの に対して既に存在する場合は、 が null、または が空の文字列である場合は、プロバイダーが例外をスローすることをお勧めします。

指定したロール名にコンマが含まれている場合は、プロバイダーが例外をスローすることをお勧めします。

たとえば、データベース内のテーブルの固定長列を使用して、データ ソースでロール名の長さが制限されている場合は、ロール名がデータ ソースで許容される最大長を超える場合は例外をスローすることをお勧めします。

こちらもご覧ください

• ロール プロバイダの実装