ScheduledItem.StartDate-Eigenschaft

Ruft ab oder legt die Coordinated Universal Time (UTC), an dem dieses ScheduledItem -Objekt einen sichtbaren Teil der veröffentlichten Website wird.

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

Syntax

'Declaration
Public Property StartDate As DateTime
    Get
    Set
'Usage
Dim instance As ScheduledItem
Dim value As DateTime

value = instance.StartDate

instance.StartDate = value

public DateTime StartDate { get; set; }

Eigenschaftswert

Typ: System.DateTime
Die Coordinated Universal Time (UTC) an dem dieser ScheduledItem einen sichtbaren Teil der veröffentlichten Website wird.

Ausnahmen

Hinweise

Der Wert 01 Januar 1900 gibt an, dass eine Instanz der ScheduledItem -Klasse einen Anfangstermin verfügt, der auf ein vergangenes Datum festgelegt ist und unmittelbar nach seiner Genehmigung veröffentlicht werden soll. Wenn das Startdatum auf 01 Januar 1900 gesetzt ist wird die Eigenschaft als "Unverzüglich" die entsprechende Benutzeroberfläche angezeigt.

Rufen Sie die ScheduledItem.LIstItem.Update -Methode, um Änderungen zu speichern, nachdem Sie diese Eigenschaft festlegen.

Datum und Uhrzeit, die von dieser Eigenschaft zurückgegeben werden, können von UTC in Ortszeit in serverseitigem Code mithilfe der SPRegionalSettings.TimeZone.UTCToLocalTime(DateTime) -Methode konvertiert werden.

Der Benutzer muss die Bearbeitungsberechtigungen auf die PublishingPage , um diesen Wert festzulegen. Der Benutzer muss die Anzeigeberechtigungen verfügen, auf dem PublishingPage zunächst die PublishingPage abrufen und seine Eigenschaftenwerte zu erhalten.

Beispiele

In diesem Beispiel wird ein Datum für Start und Ende für ein ScheduledItem -Objekt und plant das Element, damit es veröffentlicht wird, wenn das Startdatum erreicht und ist nicht veröffentlichten, wenn das Enddatum erreicht ist.

Vor dem Kompilieren und Ausführen dieses Beispiels sicher, dass der SPListItem ein Element in einer Dokumentbibliothek ist unterstützt, die Zeitplanung.

using ScheduledItem = Microsoft.SharePoint.Publishing.ScheduledItem;
using SPModerationStatusType = Microsoft.SharePoint.SPModerationStatusType;
using SPListItem = Microsoft.SharePoint.SPListItem;
using DateTime = System.DateTime;

namespace Microsoft.SDK.SharePointServer.Samples
{
    public static class ScheduledItemCodeSamples
    {
        public static void SetDatesAndSchedule(SPListItem listItem, 
          DateTime startDate, DateTime endDate)
        {
            // Set the input parameter values with
            // your own values.
            
            //
            // validate the input parameters
            if (null == listItem)
            {
                throw new System.ArgumentNullException("listItem");
            }

            // Get the ScheduledItem wrapper for the SPListItem
            // that was passed in.
            //
            ScheduledItem scheduledItem = null;
            if (ScheduledItem.IsScheduledItem(listItem))
            {
                scheduledItem = ScheduledItem.GetScheduledItem(listItem);
            }
            else
            {
                throw new System.ArgumentException
                  ("The document library containing this SPListItem must support scheduling", 
                  "listItem");
            }

            // Set and save the date values.
            scheduledItem.StartDate = startDate;
            scheduledItem.EndDate = endDate;
            scheduledItem.ListItem.Update();

            // Schedule the item so that the StartDate and EndDate
            // take effect.
            scheduledItem.Schedule();
        }        
    }
}

Imports ScheduledItem = Microsoft.SharePoint.Publishing.ScheduledItem
Imports SPModerationStatusType = Microsoft.SharePoint.SPModerationStatusType
Imports SPListItem = Microsoft.SharePoint.SPListItem


Namespace Microsoft.SDK.SharePointServer.Samples
    Public NotInheritable Class ScheduledItemCodeSamples
        Private Sub New()
        End Sub
        Public Shared Sub SetDatesAndSchedule(ByVal listItem As SPListItem, ByVal startDate As Date, ByVal endDate As Date)
            ' Set the input parameter values with
            ' your own values.

            '
            ' validate the input parameters
            If Nothing Is listItem Then
                Throw New System.ArgumentNullException("listItem")
            End If

            ' Get the ScheduledItem wrapper for the SPListItem
            ' that was passed in.
            '
            Dim scheduledItem As ScheduledItem = Nothing
            If ScheduledItem.IsScheduledItem(listItem) Then
                scheduledItem = ScheduledItem.GetScheduledItem(listItem)
            Else
                Throw New System.ArgumentException ("The document library containing this SPListItem must support scheduling", "listItem")
            End If

            ' Set and save the date values.
            scheduledItem.StartDate = startDate
            scheduledItem.EndDate = endDate
            scheduledItem.ListItem.Update()

            ' Schedule the item so that the StartDate and EndDate
            ' take effect.
            scheduledItem.Schedule()
        End Sub
    End Class
End Namespace

Siehe auch

Referenz

ScheduledItem Klasse

ScheduledItem-Member

Microsoft.SharePoint.Publishing-Namespace