RoleProvider.CreateRole(String) Metode

Definisi

Ruang nama:

System.Web.Security

Rakitan:

System.Web.ApplicationServices.dll

Menambahkan peran baru ke sumber data untuk yang dikonfigurasi 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)

Parameter

roleName

String

Nama peran yang akan dibuat.

Contoh

Contoh kode berikut menunjukkan contoh implementasi CreateRole metode .

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

Keterangan

CreateRole dipanggil dengan CreateRole metode Roles kelas untuk menambahkan peran yang ditentukan ke sumber data untuk yang dikonfigurasi ApplicationName.

Jika nama peran yang ditentukan sudah ada untuk yang dikonfigurasi applicationName, adalah null, atau merupakan string kosong, kami sarankan penyedia Anda memberikan pengecualian.

Jika nama peran yang ditentukan berisi koma, kami sarankan penyedia Anda memberikan pengecualian.

Jika sumber data Anda membatasi panjang nama peran, misalnya, melalui kolom panjang tetap tabel dalam database, kami sarankan Anda memberikan pengecualian jika nama peran melebihi panjang maksimum yang diizinkan oleh sumber data.

Lihat juga

• Menerapkan Penyedia Peran