UserProfile.Item-Eigenschaft
Ruft den Wert der angegebenen Eigenschaft ab.
Namespace: Microsoft.Office.Server.UserProfiles
Assembly: Microsoft.Office.Server.UserProfiles (in Microsoft.Office.Server.UserProfiles.dll)
Syntax
'Declaration
Public ReadOnly Default Property Item ( _
strPropName As String _
) As UserProfileValueCollection
Get
'Usage
Dim instance As UserProfile
Dim strPropName As String
Dim value As UserProfileValueCollection
value = instance(strPropName)
public UserProfileValueCollection this[
string strPropName
] { get; }
Parameter
strPropName
Typ: System.StringDer Name der Eigenschaft.
Eigenschaftswert
Typ: Microsoft.Office.Server.UserProfiles.UserProfileValueCollection
Der Wert der angegebenen Eigenschaft.
Hinweise
Die Item -Eigenschaft gibt den Wert in den Datentyp in der Profile-Eigenschaft Schema PropertyCollectionangegeben. Wenn Sie einen Eigenschaftenwert festlegen, dürfte es sein, den richtigen Datentyp oder eine Zeichenfolge, die in den richtigen Datentyp umgewandelt werden kann. Wenn eine Zeichenfolge übergeben wird, müssen alle Eigenschaften mithilfe der Portalwebsite Kultureinstellungen, mit Ausnahme der Daten, die unter Verwendung der invarianten Kultur formatiert werden müssen formatiert werden.
Wenn die Eigenschaft eine eindeutige ID-Eigenschaft ist und aus dem Active Directory-Verzeichnisdienst importiert wird, könnte das Rückgabeobjekt Byte[] anstelle von Sytem.GUID.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie die eindeutige ID-Eigenschaft abrufen:
UserProfileManager upm = new UserProfileManager();
UserProfile user = upm.GetUserProfile("domain\user");
System.Guid guidAUserProperty = GetGUIDProperty(user["AGuidProperty"]);
System.Guid GetGUIDProperty(object objPropValue) {
if (objPropValue is System.Guid) return (Guid) objPropValue;
else if (objPropValue is byte[]) return new Guid((byte[]) objPropValue);
else throw new ArgumentException("...");
return Guid.Empty;
}