Incorporer des images, des vidéos et des documents dans les publications dans SharePoint
Découvrez comment ajouter des objets SocialAttachment à des billets de microblog, qui s’affiche sous la mesure d’images incorporées, de vidéos et de documents dans SharePoint flux sociaux.
Dans un flux de mise en réseau, la forme la plus simple de contenu de publication contienne du texte uniquement, mais vous pouvez également ajouter des documents, des vidéos et des images incorporées. Pour ce faire, vous utilisez la propriété Attachment sur l'objet SocialPostCreationData qui définit le billet de blog. Billets peuvent contenir une pièce jointe, ce qui est représentée par un objet SocialAttachment .
Notes
[!REMARQUE] To add a mention, tag, or link to a post's content, you add a SocialDataItem object to the SocialPostCreationData.ContentItems property. Pour plus d’informations, voir How to: Include mentions, tags, and links to sites and documents in posts in SharePoint.
L'API décrite dans cet article est à partir du modèle d'objet client .NET. Si vous utilisez un autre API, telles que le JavaScript du modèle objet, les noms d'objets ou l'API correspondante peut être différente. Pour obtenir des liens vers la documentation pour les API connexes, reportez-vous à la section Ressources supplémentaires .
Conditions requises pour utiliser les exemples de code pour ajouter des pièces jointes à un billet
Les exemples de code dans cet article indiquent comment ajouter une image, vidéo, et publie des pièces jointes au document pour microblog. Ces exemples sont à partir d'une application console qui utilise les assemblys SharePoint suivants :
Microsoft.SharePoint.Client
Microsoft. SharePoint. Client.Runtime
Microsoft. SharePoint. Client.UserProfilies
Pour utiliser les exemples de cet article, vous devez télécharger une image, une vidéo et un document. Pour utiliser l'exemple de vidéo, la fonctionnalité vidéo doit être activée sur le serveur et le fichier vidéo doit être stocké dans une bibliothèque de biens. Pour utiliser l'exemple de document dans un environnement local, Office Online doit être configuré dans l'environnement. Pour plus d’informations, voir Planifier les bibliothèques de biens numériques dans SharePoint et Configurer SharePoint pour utiliser Office Online.
Pour obtenir des instructions sur la façon de configurer votre environnement de développement et de créer une application console, voir Comment : créer et supprimer des billets et récupérer le flux social à l’aide du modèle objet client .NETdans SharePoint .
Exemple : incorporer une image dans un billet dans SharePoint
L'exemple de code suivant publie un billet contenant une image incorporée. Il montre comment :
Créer un objet SocialAttachment qui représente l'image. Le SocialAttachment Spécifie le champ SocialAttachmentKind.Image et l'URI du fichier image.
Ajoutez l'objet image à la propriété Attachment de l'objet SocialPostCreationData qui est utilisée pour créer le billet de blog.
Modifier les valeurs d'espace réservé pour les variables d'URL avant d'exécuter le code.
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Microsoft.SharePoint.Client;
using Microsoft.SharePoint.Client.Social;
namespace EmbedImageInPost
{
class Program
{
static void Main(string[] args)
{
// Replace the following placeholder values with the actual values.
const string serverUrl = "http://serverName/siteName/";
const string imageUrl = "http://serverName/Shared%20Documents/imageName.jpg";
// Define the image attachment that you want to embed in the post.
SocialAttachment attachment = new SocialAttachment()
{
AttachmentKind = SocialAttachmentKind.Image,
Uri = imageUrl
};
// Define properties for the post and add the attachment.
SocialPostCreationData postCreationData = new SocialPostCreationData();
postCreationData.ContentText = "Look at this!";
postCreationData.Attachment = attachment;
try
{
// Get the context and the SocialFeedManager instance.
ClientContext clientContext = new ClientContext(serverUrl);
SocialFeedManager feedManager = new SocialFeedManager(clientContext);
// Publish the post. This is a root post to the user's feed, so specify
// null for the targetId parameter.
feedManager.CreatePost(null, postCreationData);
clientContext.ExecuteQuery();
Console.Write("The post was published.");
Console.ReadLine();
}
catch (Exception ex)
{
Console.Write("Error publishing the post: " + ex.Message);
Console.ReadLine();
}
}
}
}
Incorporer une vidéo dans un billet dans SharePoint
L'exemple de code suivant publie un billet contenant une vidéo incorporée. Il montre comment :
Obtenez l'objet SocialAttachment qui représente la pièce jointe vidéo à l'aide de la méthode SocialFeedManager.GetPreview .
Ajouter la vidéo des pièces jointes à la propriété Attachment de l'objet SocialPostCreationData qui est utilisée pour créer le billet de blog.
Cet exemple requiert les fonctionnalités vidéo pour être activé sur le serveur et le fichier vidéo d'être téléchargés depuis une bibliothèque de biens. Consultez les conditions requises pour utiliser les exemples de code pour plus d'informations.
Modifier les valeurs d'espace réservé pour les variables d'URL avant d'exécuter le code.
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Microsoft.SharePoint.Client;
using Microsoft.SharePoint.Client.Social;
namespace EmbedVideoInPost
{
class Program
{
static void Main(string[] args)
{
// Replace the following placeholder values with the actual values.
const string serverUrl = "http://serverName/siteName/";
const string videoUrl = "http://serverName/Asset%20Library/fileName?Web=1";
try
{
// Get the context and the SocialFeedManager instance.
ClientContext clientContext = new ClientContext(serverUrl);
SocialFeedManager feedManager = new SocialFeedManager(clientContext);
// Get the video attachment from the server.
ClientResult<SocialAttachment> attachment = feedManager.GetPreview(videoUrl);
clientContext.ExecuteQuery();
// Define properties for the post and add the attachment.
SocialPostCreationData postCreationData = new SocialPostCreationData();
postCreationData.ContentText = "Look at this!";
postCreationData.Attachment = attachment.Value;
// Publish the post. This is a root post to the user's feed, so specify
// null for the targetId parameter.
feedManager.CreatePost(null, postCreationData);
clientContext.ExecuteQuery();
Console.Write("The post was published.");
Console.ReadLine();
}
catch (Exception ex)
{
Console.Write("Error publishing the post: " + ex.Message);
Console.ReadLine();
}
}
}
}
Exemple : incorporer un document dans un billet de SharePoint
L'exemple de code suivant publie un billet contenant un document incorporé. Il montre comment :
Obtenez l'objet SocialAttachment qui représente le document joint à l'aide de la méthode SocialFeedManager.GetPreview .
Ajouter le document joint à la propriété Attachment de l'objet SocialPostCreationData qui est utilisée pour créer le billet de blog.
To use this example in an on-premises environment, your environment must be configured to use Office Online. See the prerequisites for using the code examples for more information. Dans le cas contraire, vous pouvez publier un lien vers le document comme décrit dans comment : inclure des mentions,des balises et des liens vers des sites et des documents dans les publications dans SharePoint .
[!REMARQUE] Modifier les valeurs d'espace réservé pour les variables d'URL avant d'exécuter le code.
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Microsoft.SharePoint.Client;
using Microsoft.SharePoint.Client.Social;
namespace EmbedDocumentInPost
{
class Program
{
static void Main(string[] args)
{
// Replace the following placeholder values with the actual values.
const string serverUrl = "http://serverName";
const string documentUrl = "http://serverName/Shared%20Documents/fileName.docx";
try
{
// Get the context and the SocialFeedManager instance.
ClientContext clientContext = new ClientContext(serverUrl);
SocialFeedManager feedManager = new SocialFeedManager(clientContext);
// Get the document attachment from the server.
ClientResult<SocialAttachment> attachment = feedManager.GetPreview(documentUrl);
clientContext.ExecuteQuery();
// Define properties for the post and add the attachment.
SocialPostCreationData postCreationData = new SocialPostCreationData();
postCreationData.ContentText = "Post with a document.";
postCreationData.Attachment = attachment.Value;
// Publish the post. This is a root post to the user's feed, so specify
// null for the targetId parameter.
feedManager.CreatePost(null, postCreationData);
clientContext.ExecuteQuery();
Console.Write("The post was published.");
Console.ReadLine();
}
catch (Exception ex)
{
Console.Write("Error publishing the post: " + ex.Message);
Console.ReadLine();
}
}
}
}
Voir aussi
SocialPostCreationData et SocialAttachment dans les modèles objet client
SocialPostCreationData et SocialAttachment dans le modèle d'objet JavaScript
SPSocialPostCreationData et SPSocialAttachment dans le modèle objet serveur