SPAudit.WriteAuditEvent-Methode (SPAuditEventType, String, String)

Artikel
05/06/2015

Schreiben eines Datensatzes zu einem Ereignis auf der SharePoint-Datenbank.

Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

'Declaration
Public Function WriteAuditEvent ( _
    eventId As SPAuditEventType, _
    eventSource As String, _
    xmlData As String _
) As Boolean
'Usage
Dim instance As SPAudit
Dim eventId As SPAuditEventType
Dim eventSource As String
Dim xmlData As String
Dim returnValue As Boolean

returnValue = instance.WriteAuditEvent(eventId, _
    eventSource, xmlData)

public bool WriteAuditEvent(
    SPAuditEventType eventId,
    string eventSource,
    string xmlData
)

Parameter

eventId
Typ: Microsoft.SharePoint.SPAuditEventType

Die Art des Ereignisses aufgezeichnet werden.

eventSource
Typ: System.String

Der Name der aufrufenden Anwendung.

xmlData
Typ: System.String

Die Informationen über das Ereignis.

Rückgabewert

Typ: System.Boolean
true in allen Fällen.

Hinweise

Verwenden Sie diese Methode, um Datensätze von benutzerdefinierten Ereignistypen oder benutzerdefinierte Versionen der vorhandenen Ereignistypen zu schreiben. Custom für eventID übergeben Sie, wenn Sie ein benutzerdefiniertes Ereignis schreiben. (Wenn Sie mehr als einen Typ des benutzerdefinierten Ereignisses und Unterscheidung Prüfungsberichte werden soll, verwenden Sie die Überladung der Methode des WriteAuditEvent(String, String, String) .) Wenn Ihr Ereignis einer vorhandenen SPAuditEventType Objekte ähnelt, und Sie möchten, dass er in Überwachungsberichte für diesen Typ eines Ereignisses enthalten, übergeben Sie den entsprechenden SPAuditEventType -Wert für eventID.

Übergeben Sie den Namen der SharePoint-Lösung als eventSource. Übergeben Sie optional bis zu 4000 Zeichen der zusätzliche Informationen über das Ereignis als xmlData.

Können Sie ein XML-Schema xmlDataformatieren möchten, oder Sie können nicht definierte XML verwenden. Jedoch wenn Sie Daten einfügen, die im Wesentlichen dem Ereignisdaten entspricht dieser SharePoint Foundation verwendet im integrierten Ereignisse, lesen; Verarbeitung von Datenbank-Datensätzen ist einfacher, wenn Sie den gleichen Tags verwenden Z. B. verweist die Ereignisdaten für ein Objekt als dem, auf dem das Ereignis ausgelöst wurde, verwenden Sie das Muster <RelatedItem><Id>GUID_of_other_object</Id><Relationship>some_relationship</Relationship></RelatedItem>, ähnlich wie SharePoint Foundation für ChildDelete -Ereignisse verwendet. Finden Sie im Thema SPAuditEntry.EventData für Weitere Informationen zu den XML-, SharePoint Foundation Tags verwendet.

Beispiele

Im folgende Beispiel (aus Item-Level Auditing with SharePoint Server 2007) zeigt diese Methode verwendet.

SPList oList = oSiteCollection.Lists[new Guid(ListId)];
SPListItem oListItem = oList.Items.GetItemById(Convert.ToInt32(ItemId));
oListItem.Audit.WriteAuditEvent(SPAuditEventType.Custom, 
                           "CustomViewAuditEvent",  // SoureName
                           "<myXml>MyData</myXml>"  // Any arbitrary XML data
                           );

Dim oList As SPList = oSiteCollection.Lists(New Guid(ListId))
Dim oListItem As SPListItem = oList.Items.GetItemById(Convert.ToInt32(ItemId))
oListItem.Audit.WriteAuditEvent(SPAuditEventType.Custom, "CustomViewAuditEvent", "<myXml>MyData</myXml>") ' Any arbitrary XML data -  SoureName