_PropertyAccessor.SetProperties(Object, Object) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Legt die vom Array SchemaNames angegebenen Eigenschaften auf die werte fest, die vom Array Valuesangegeben werden.
public:
System::Object ^ SetProperties(System::Object ^ SchemaNames, System::Object ^ Values);public object SetProperties (object SchemaNames, object Values);Public Function SetProperties (SchemaNames As Object, Values As Object) As ObjectParameter
- SchemaNames
- Object
Ein Array von Namen von Eigenschaften, deren Werte gemäß der Angabe durch den Values-Parameter festgelegt werden sollen. Auf diese Eigenschaften wird mithilfe von Namespaces verwiesen. Weitere Informationen finden Sie unter Verweisen auf Eigenschaften nach Namespace.
- Values
- Object
Ein Array aus Werten, die für die durch den SchemaNames-Parameter angegebenen Eigenschaften festgelegt werden sollen.
Gibt zurück
Ein Objekt , das Nothing ist (ein NULL-Verweis (Nothing in Visual Basic) in C#), wenn der Vorgang erfolgreich ist. Wenn ein Fehler aufgetreten ist, bevor alle Eigenschaften festgelegt werden, beispielsweise die Anzahl der Elemente im Array SchemaNames stimmt nicht überein, die im Array Values und ein Err -Wert zurückgegeben. Wenn beim Festlegen der Eigenschaften ein Fehler aufgetreten ist, ist der Rückgabewert ein Array von Err -Objekten, mit der Anzahl der Elemente in diesem Array wird das Array SchemaNames identisch. Ein Wert Err im Array ist das Fehlerergebnis durch Festlegen der entsprechenden Eigenschaft im Parameter SchemaNames zugeordnet.
Hinweise
Wenn die Eigenschaft nicht vorhanden ist und das SchemaNames Element einen gültigen Eigenschaftenspezifizierer enthält, erstellt SetProperties die Eigenschaft und weist die Eigenschaft mit dem durch Valuesangegebenen Wert zu. Der Typ der Eigenschaft ist der Typ des elements, das in Valuesübergeben wird. Wenn die Eigenschaft vorhanden ist, weist SetProperties der Eigenschaft den von angegebenen Wert zu Values.
Beachten Sie, dass eine mithilfe von PropertyAccessor erstellte benutzerdefinierte Eigenschaft in einer benutzerdefinierten Ansicht nicht unterstützt wird. Wenn Sie eine benutzerdefinierte Eigenschaft für ein Element anzeigen möchten, erstellen Sie die -Eigenschaft mithilfe der Add(String, OlUserPropertyType, Object, Object) -Methode.
Wenn das übergeordnete Objekt des PropertyAccessor einen expliziten Save-Vorgang unterstützt, sollten die Eigenschaften mit einem expliziten Aufruf der Save-Methode im -Objekt gespeichert werden. Wenn das Objekt nicht explizit unterstützt Vorgang Speichern, und klicken Sie dann auf die Eigenschaften auf das Objekt gespeichert werden, wenn SetProperties aufgerufen wird.
Gehen Sie vorsichtig vor, und stellen Sie sicher, dass alle Ausnahmen korrekt behandelt werden. Beispiele für Bedingungen, unter denen das Festlegen von Eigenschaften fehlschlägt:
Weitere Informationen zum Festlegen von Eigenschaften mithilfe des PropertyAccessor-Objekts finden Sie unter Bewährte Methoden zum Abrufen und Festlegen von Eigenschaften.