This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

RoleProvider.CreateRole أسلوب

Visual Studio 2010

قم بإضافة دور جديد إلى مصدر بيانات الخاص بالمكون applicationName.

مساحة الاسم:  System.Web.Security
التجميع:  System.Web.ApplicationServices (في System.Web.ApplicationServices.dll)

public abstract void CreateRole(
	string roleName
)

المعلمات

roleName
النوع: System.String
اسم الدور إلى إنشاء.

CreateRole هو استدعاؤها بواسطةCreateRoleأسلوبRolesفئة لإضافة الدور المحدد لمصدر بيانات الخاص المكونApplicationName.

إذا كان اسم الدور المحدد موجود بالفعل تم تكوينه applicationName، هو null، أو سلسلة فارغ، يستحسن بك موفر الإلقاء على ‏‏ استثناء.

إذا تضمن اسم الدور المحدد فاصلة، يستحسن بك موفر قم بطرح استثناء.

إذا كانت البيانات الخاصة بك المصدر قم بتقييد الطول اسم الدور، على سبيل المثال، من خلال عمود ذات طول ثابت من جدول في قاعدة بيانات، نوصي طرح استثناء إذا كان اسم دور يتجاوز الحد الأقصى للطول المسموح به من قبل البيانات المصدر.

يوضح مثال التعليمة البرمجية التالية تنفيذ نموذج ما في 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();      
  }
}


نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0

NET Framework. Client Profile

مدعوم في: 4
إظهار: