Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

ProfileBase.GetProfileGroup-Methode

Hinweis: Diese Methode ist neu in .NET Framework, Version 2.0.

Ruft eine Gruppe von Eigenschaften ab, die durch einen Gruppennamen bezeichnet werden.

Namespace: System.Web.Profile
Assembly: System.Web (in system.web.dll)

public ProfileGroupBase GetProfileGroup (
	string groupName
)
public ProfileGroupBase GetProfileGroup (
	String groupName
)
public function GetProfileGroup (
	groupName : String
) : ProfileGroupBase

Parameter

groupName

Der Name der Gruppe von Eigenschaften.

Rückgabewert

Ein ProfileGroupBase-Objekt für eine mit dem angegebenen Gruppennamen konfigurierte Gruppe von Eigenschaften.
AusnahmetypBedingung

System.Configuration.Provider.ProviderException

Der angegebene Gruppenname für Profileigenschaften wurde nicht im Konfigurationsabschnitt properties gefunden.

Profileigenschaften können für eine bessere Organisation in Gruppen aufgeteilt werden. Die GetProfileGroup-Eigenschaft kann zum Abrufen einer Eigenschaftengruppe über den Gruppennamen verwendet werden. Sie können auf eine Profileigenschaft in einer Gruppe auch zugreifen, indem Sie den Gruppennamen als Member der auf jeder Seite verfügbaren Profile-Eigenschaft angeben. Beispielsweise kann auf die ZipCode-Profileigenschaft, die Member der Address-Profilgruppe ist, mithilfe von Profile.Address.ZipCode zugegriffen werden.

Die folgende Datei Web.config gibt ein Benutzerprofil an, das eine Gruppe von Eigenschaften mit dem Gruppennamen Address enthält. Den für die Profile-Eigenschaft des aktuellen HttpContext generierten Gruppeneigenschaften steht der Gruppenname voran. Beispiel: Profile.Address.Street.

<configuration>
  <connectionStrings>
    <add name="SqlServices" connectionString=
      "Data Source=localhost;Integrated Security=SSPI;Initial Catalog=aspnetdb;" />
  </connectionStrings>

  <system.web>
    <authentication mode="Forms" >
      <forms loginUrl="login.aspx"
        name=".ASPXFORMSAUTH" />
    </authentication>

    <authorization>
      <deny users="?" />
    </authorization>

    <membership defaultProvider="SqlProvider" 
      userIsOnlineTimeWindow="15">
      <providers>
        <clear />
        <add 
          name="SqlProvider" 
          type="System.Web.Security.SqlMembershipProvider" 
          connectionStringName="SqlServices"
          enablePasswordRetrieval="false"
          enablePasswordReset="true"
          requiresQuestionAndAnswer="true" 
          requiresUniqueEmail="false"
          passwordFormat="Hashed"
          applicationName="MyApplication" />
      </providers>
    </membership>

    <profile defaultProvider="SqlProvider">
      <providers>
        <add
          name="SqlProvider"
          connectionStringName="SqlServices"
          applicationName="MyApplication"
          type="System.Web.Profile.SqlProfileProvider" />
            
      </providers>

      <properties>
        <add name="ZipCode" />
        <group name="Address">
          <add name="Street" />
          <add name="City" />
          <add name="State" />
          <add name="CountryOrRegion" />
        </group>
      </properties>
    </profile>
  </system.web>
</configuration>

Die folgende ASP.NET-Seite liest die für das Benutzerprofil angegebenen Gruppeneigenschaften und legt diese fest.

<%@ Page Language="C#" %>
<script runat="server">

public void Page_Load()
{
  if (!IsPostBack)
  {
    StreetTextBox.Text          = Profile.Address.Street;
    CityTextBox.Text            = Profile.Address.City;
    StateTextBox.Text           = Profile.Address.State;
    CountryOrRegionTextBox.Text = Profile.Address.CountryOrRegion;
    ZipCodeTextBox.Text         = Profile.ZipCode;
  }
}

public void UpdateButton_OnClick(object sender, EventArgs args)
{
  Profile.Address.Street          = StreetTextBox.Text;
  Profile.Address.City            = CityTextBox.Text;
  Profile.Address.State           = StateTextBox.Text;
  Profile.Address.CountryOrRegion = CountryOrRegionTextBox.Text;
  Profile.ZipCode                 = ZipCodeTextBox.Text;
}

</script>
<html>
<head>
<title>Home Page</title>
</head>
<body>
<h3>Address Information for <%=User.Identity.Name%></h3>
<form runat="server">
  <table border=1 cellpadding=2 cellspacing=2>
    <tr>
      <td>Street Address</td>
      <td><asp:Textbox id="StreetTextBox" runat="server" columns="30" /></td>
    </tr>
    <tr>
      <td>City</td>
      <td><asp:Textbox id="CityTextBox" runat="server" columns="20" /></td>
    </tr>
    <tr>
      <td>State</td>
      <td><asp:Textbox id="StateTextBox" runat="server" columns="20" /></td>
    </tr>
    <tr>
      <td>Zip Code</td>
      <td><asp:Textbox id="ZipCodeTextBox" runat="server" columns="10" /></td>
    </tr>
    <tr>
      <td>Country</td>
      <td><asp:Textbox id="CountryOrRegionTextBox" runat="server" columns="20" /></td>
    </tr>
  </table>
  <asp:Button id="UpdateButton" runat="server" OnClick="UpdateButton_OnClick" Text="Update Address" />
</form>

</body>
</html>

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 unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

.NET Framework

Unterstützt in: 2.0
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
© 2013 Microsoft. Alle Rechte vorbehalten.