PublishingPage.Contact - Propriété
Obtient ou définit l'utilisateur auquel appartient cet objet PublishingPage .
Espace de noms : Microsoft.SharePoint.Publishing
Assembly : Microsoft.SharePoint.Publishing (dans Microsoft.SharePoint.Publishing.dll)
Syntaxe
'Déclaration
Public Property Contact As SPUser
Get
Set
'Utilisation
Dim instance As PublishingPage
Dim value As SPUser
value = instance.Contact
instance.Contact = value
public SPUser Contact { get; set; }
Valeur de propriété
Type : Microsoft.SharePoint.SPUser
L'objet SPUser qui représente l'utilisateur qui possède actuellement cette PublishingPage
Exceptions
Exception | Condition |
---|---|
[UnauthorizedAccessException] | l'utilisateur actuel ne dispose pas des autorisations suffisantes pour effectuer cette action. |
Remarques
La propriété Contact est la propriété par défaut pour le suivi d'un SPUser qui possède un PublishingPage. Toutefois, si vous ne spécifiez pas une valeur Contact , les propriétés LocalContactName, LocalContactEmailet LocalContactImage fournissent les informations utilisateur qui sont spécifiques à ce PublishingPage. Ces valeurs sont uniquement pertinents pour le spécifié PublishingPage et n'ont aucun effet sur tous les objets SPUser sur le site.
La propriété Contact s'excluent mutuellement les propriétés LocalContactName, LocalContactEmailet LocalContactImage . Définition des propriétés LocalContactName, LocalContactE-mailou LocalContactImage sur une valeur qui n'est pas vide et non-null efface la propriété Contact . De même, la définition de la propriété Contact sur une valeur qui n'est pas nulle efface les propriétés LocalContactName, LocalContactE-mailet LocalContactImage .
Vous pouvez définir la valeur de Contact à une référence Null (Rien dans Visual Basic).
Pour enregistrer les modifications apportées après la définition de la propriété Contact , vous devez appeler la méthode Update .
Pour définir cette valeur, l'utilisateur doit avoir les deux permet d'afficher et modifier les autorisations sur le PublishingPage., afficher les autorisations pour récupérer la page et pour renvoyer les valeurs de ses propriétés et modifier les autorisations pour modifier la valeur.
Exemples
Cet exemple montre comment définit certaines propriétés sur un objet PublishingPage , enregistre les nouvelles valeurs et publie le PublishingPage.
Avant de compiler et exécuter cet exemple, vérifiez que ce SPLIstItem est un élément de liste dans la bibliothèque de documents pages d'un PublishingWeb.
Cet exemple suppose que la bibliothèque de documents qui contient le SPListItem nécessite l'approbation du contenu.
using PublishingPage = Microsoft.SharePoint.Publishing.PublishingPage;
using SPListItem = Microsoft.SharePoint.SPListItem;
using SPFile = Microsoft.SharePoint.SPFile;
using SPModerationStatusType = Microsoft.SharePoint.SPModerationStatusType;
using PublishingWeb = Microsoft.SharePoint.Publishing.PublishingWeb;
using SPUser = Microsoft.SharePoint.SPUser;
using PageLayout = Microsoft.SharePoint.Publishing.PageLayout;
using PublishingPageCollection = Microsoft.SharePoint.Publishing.PublishingPageCollection;
namespace Microsoft.SDK.SharePointServer.Samples
{
public static class PublishingPageCodeSamples
{
public static void SetPagePropertiesAndApprove(SPListItem listItem, SPUser pageContact)
{
// Replace these variable values and input parameters with your own values.
//
// New PublishingPage.Title value
string newTitle = "your Title";
//
// New PublishingPage.Description value
string newDescription = "your Description";
//
// The comment to set when the page is checked in, published, and approved.
string checkInComment = "Your comments";
// Validate the input parameters.
//
if (null == listItem)
{
throw new System.ArgumentNullException("listItem");
}
if (null == pageContact)
{
throw new System.ArgumentNullException("pageContact");
}
// Get the PublishingPage wrapper for the SPListItem that was passed in.
//
PublishingPage publishingPage = null;
if (PublishingPage.IsPublishingPage(listItem))
{
publishingPage = PublishingPage.GetPublishingPage(listItem);
}
else
{
throw new System.ArgumentException("This SPListItem is not a PublishingPage", "listItem");
}
// Check out the page if it is not checked out yet.
//
if (publishingPage.ListItem.File.CheckOutStatus == SPFile.SPCheckOutStatus.None)
{
publishingPage.CheckOut();
}
// Set and save some properties on the PublishingPage.
//
publishingPage.Title = newTitle;
publishingPage.Description = newDescription;
publishingPage.Contact = pageContact;
publishingPage.Update();
// Publish the page, and approve it if required, so that the updated
// values are visible on the published Web site.
//
publishingPage.CheckIn(checkInComment);
SPFile pageFile = publishingPage.ListItem.File;
pageFile.Publish(checkInComment);
pageFile.Approve(checkInComment);
}
}
}
Imports PublishingPage = Microsoft.SharePoint.Publishing.PublishingPage
Imports SPListItem = Microsoft.SharePoint.SPListItem
Imports SPFile = Microsoft.SharePoint.SPFile
Imports SPModerationStatusType = Microsoft.SharePoint.SPModerationStatusType
Imports PublishingWeb = Microsoft.SharePoint.Publishing.PublishingWeb
Imports SPUser = Microsoft.SharePoint.SPUser
Imports PageLayout = Microsoft.SharePoint.Publishing.PageLayout
Imports PublishingPageCollection = Microsoft.SharePoint.Publishing.PublishingPageCollection
Namespace Microsoft.SDK.SharePointServer.Samples
Public NotInheritable Class PublishingPageCodeSamples
Private Sub New()
End Sub
Public Shared Sub SetPagePropertiesAndApprove(ByVal listItem As SPListItem, ByVal pageContact As SPUser)
' Replace these variable values and input parameters with your own values.
'
' New PublishingPage.Title value
Dim newTitle As String = "your Title"
'
' New PublishingPage.Description value
Dim newDescription As String = "your Description"
'
' The comment to set when the page is checked in, published, and approved.
Dim checkInComment As String = "Your comments"
' Validate the input parameters.
'
If Nothing Is listItem Then
Throw New System.ArgumentNullException("listItem")
End If
If Nothing Is pageContact Then
Throw New System.ArgumentNullException("pageContact")
End If
' Get the PublishingPage wrapper for the SPListItem that was passed in.
'
Dim publishingPage As PublishingPage = Nothing
If PublishingPage.IsPublishingPage(listItem) Then
publishingPage = PublishingPage.GetPublishingPage(listItem)
Else
Throw New System.ArgumentException("This SPListItem is not a PublishingPage", "listItem")
End If
' Check out the page if it is not checked out yet.
'
If publishingPage.ListItem.File.CheckOutStatus = SPFile.SPCheckOutStatus.None Then
publishingPage.CheckOut()
End If
' Set and save some properties on the PublishingPage.
'
publishingPage.Title = newTitle
publishingPage.Description = newDescription
publishingPage.Contact = pageContact
publishingPage.Update()
' Publish the page, and approve it if required, so that the updated
' values are visible on the published Web site.
'
publishingPage.CheckIn(checkInComment)
Dim pageFile As SPFile = publishingPage.ListItem.File
pageFile.Publish(checkInComment)
pageFile.Approve(checkInComment)
End Sub
End Class
End Namespace