Freigeben über


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.

Siehe auch

Referenz

SPItemEventProperties-Member

Microsoft.SharePoint-Namespace