SPItemEventProperties-Klasse
Enthält Informationen zu Listenelementereignisse an.
Vererbungshierarchie
System.Object
Microsoft.SharePoint.SPEventPropertiesBase
Microsoft.SharePoint.SPItemEventProperties
Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaration
<SerializableAttribute> _
Public NotInheritable Class SPItemEventProperties _
Inherits SPEventPropertiesBase _
Implements IDisposable
'Usage
Dim instance As SPItemEventProperties
[SerializableAttribute]
public sealed class SPItemEventProperties : SPEventPropertiesBase,
IDisposable
Hinweise
Die SPItemEventProperties -Klasse enthält Informationen zu einem Elementereignis, einschließlich feste Eigenschaften des Ereignisses wie Ereignistyp, Benutzernamen und URL; Darüber hinaus Before und After Eigenschaften des Listenelements, für die das Ereignis ausgelöst wird, wenn die Eigenschaften zur Verfügung stehen. Die Definitionen der Eigenschaften Before und After für After -Ereignisse sind einfach: Before Eigenschaften beziehen sich auf Einstellungen, die an, bevor das Ereignis aufgetreten ist, und After Eigenschaften beziehen sich auf die Einstellungen, die nach dem das Ereignis eingetreten ist vorhanden. Before Ereignisse finden Sie jedoch Before Eigenschaften zum aktuellen Elementeinstellungen, bevor das Ereignis auftritt, während After Eigenschaften auf Einstellungen verweisen möchten, die nach Eintreten des Ereignisses das Element aufweist.
Beispiele
Das folgende Codebeispiel verwendet die SPItemEventProperties -Klasse zur Begrenzung der Anzahl der Elemente, die einer Liste hinzugefügt werden können.
using System;
using Microsoft.SharePoint;
namespace Example_Namespace
{
public class Class_Name : SPItemEventReceiver
{
public override void ItemAdding(SPItemEventProperties properties)
{
using(SPWeb oWebsite = new SPSite(properties.SiteId).OpenWeb(properties.RelativeWebUrl))
{
SPListItemCollection collItems = oWebsite.Lists[properties.ListTitle].Items;
if (collItems.Count > 150)
{
properties.Cancel = true;
properties.ErrorMessage = "Adding items to this list is not supported because it already contains " +
colItems.Count.ToString() + " items.";
}
}
}
}
}
Imports System
Imports Microsoft.SharePoint
Namespace Example_Namespace
Public Class Class_Name
Inherits SPItemEventReceiver
Public Overrides Sub ItemAdding(ByVal properties As SPItemEventProperties)
Using oWebsite As SPWeb = New SPSite(properties.SiteId).OpenWeb(properties.RelativeWebUrl)
Dim collItems As SPListItemCollection = oWebsite.Lists(properties.ListTitle).Items
If collItems.Count > 150 Then
properties.Cancel = True
properties.ErrorMessage = "Adding items to this list is not supported because it already contains " & colItems.Count.ToString() & " items."
End If
End Using
End Sub
End Class
End Namespace
Hinweis
Bestimmte Objekte, die IDisposable -Schnittstelle implementieren, und müssen Sie vermeiden, diese Objekte im Arbeitsspeicher beibehalten, wenn sie nicht mehr benötigt werden. Informationen zu bewährten Codierung finden Sie unter Disposing Objects.
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Die Threadsicherheit von Instanzmembern ist nicht gewährleistet.