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는 클래스의 Roles 메서드에 의해 CreateRole 호출되어 구성된 ApplicationName의 데이터 원본에 지정된 역할을 추가합니다.

구성된 applicationName에 대해 지정된 역할 이름이 이미 있는 경우 가 null이거나 빈 문자열인 경우 공급자가 예외를 throw하는 것이 좋습니다.

지정된 역할 이름에 쉼표가 포함된 경우 공급자가 예외를 throw하는 것이 좋습니다.

예를 들어 데이터 원본이 데이터베이스에 있는 테이블의 고정 길이 열을 통해 역할 이름의 길이를 제한하는 경우 역할 이름이 데이터 원본에서 허용하는 최대 길이를 초과하는 경우 예외를 throw하는 것이 좋습니다.

추가 정보

• 역할 공급자 구현