ProfileBase.GetProfileGroup-Methode
Assembly: System.Web (in system.web.dll)
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.| Ausnahmetyp | Bedingung |
|---|---|
| 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.
Referenz
ProfileBase-KlasseProfileBase-Member
System.Web.Profile-Namespace