SPAudit.WriteAuditEvent method (String, String, String)

Artigo
05/12/2015

Grava um registro de um evento para o banco de dados do SharePoint.

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

Syntax

'Declaração
Public Function WriteAuditEvent ( _
    eventName As String, _
    eventSource As String, _
    xmlData As String _
) As Boolean
'Uso
Dim instance As SPAudit
Dim eventName As String
Dim eventSource As String
Dim xmlData As String
Dim returnValue As Boolean

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

public bool WriteAuditEvent(
    string eventName,
    string eventSource,
    string xmlData
)

Parâmetros

eventName
Type: System.String

O tipo de evento a ser registrado.

eventSource
Type: System.String

O nome do aplicativo de chamada.

xmlData
Type: System.String

As informações sobre o evento.

Valor retornado

Type: System.Boolean
true em todos os casos.

Comentários

Use esse método para gravar registros de eventos personalizados quando você tem vários tipos de eventos personalizados e necessário o evento registrar para ser mais específico do que apenas "personalizado". Passe o nome de um dos seus tipos de evento personalizado para eventName. Passe o nome da solução do SharePoint como eventSource. Opcionalmente, passe até 4000 caracteres de informações adicionais sobre o evento, como xmlData.

Você pode usar qualquer esquema XML que você deseja formatar xmlDataou você pode usar XML indefinido. No entanto, quando você está incluindo dados que são essencialmente os mesmos que os dados de evento que SharePoint Foundation usa em seus eventos internos, ler e processar os registros do banco de dados é mais fácil se você usar as mesmas marcas. Por exemplo, se seus dados de evento se refere a um objeto diferente em que o evento foi gerado, use o padrão <RelatedItem><Id>GUID_of_other_object</Id><Relationship>some_relationship</Relationship></RelatedItem>, que é semelhante ao que SharePoint Foundation usa para eventos de ChildDelete . Consulte o tópico para SPAuditEntry.EventData para obter mais informações sobre o XML marcas que SharePoint Foundation usa.