del método HtmlValidationContext.ValidateImageValue
Quita direcciones URL y el código HTML no seguro o no permitido marcado y devuelve un parámetro validado imageValue .
Espacio de nombres: Microsoft.SharePoint.Publishing.Fields
Ensamblado: Microsoft.SharePoint.Publishing (en Microsoft.SharePoint.Publishing.dll)
Sintaxis
'Declaración
Public Function ValidateImageValue ( _
imageValue As ImageFieldValue, _
<OutAttribute> ByRef tagsWereDropped As Boolean, _
<OutAttribute> ByRef urlsWereDropped As Boolean _
) As ImageFieldValue
'Uso
Dim instance As HtmlValidationContext
Dim imageValue As ImageFieldValue
Dim tagsWereDropped As Boolean
Dim urlsWereDropped As Boolean
Dim returnValue As ImageFieldValue
returnValue = instance.ValidateImageValue(imageValue, _
tagsWereDropped, urlsWereDropped)
public ImageFieldValue ValidateImageValue(
ImageFieldValue imageValue,
out bool tagsWereDropped,
out bool urlsWereDropped
)
Parámetros
imageValue
Tipo: Microsoft.SharePoint.Publishing.Fields.ImageFieldValueEl objeto ImageFieldValue que se valida.
tagsWereDropped
Tipo: System.BooleanDevolución, este parámetro se establece a True si las etiquetas no permitidas se encontraron y eliminan durante la validación, en caso contrario, False.
urlsWereDropped
Tipo: System.BooleanDevolución, este parámetro se establece a True si se encontraron todas las direcciones URL no permitida y eliminan durante la validación, en caso contrario, False.
Valor devuelto
Tipo: Microsoft.SharePoint.Publishing.Fields.ImageFieldValue
El valor de imagen validado, desde el que se elimina todo el contenido no seguro o no permitido.
Comentarios
Quita las etiquetas, atributos o marcado de un objeto ImageFieldValue que no son seguros o no se ajustan a la configuración de restricciones que se aplica a este objeto HtmlValidationContext .
Las siguientes propiedades no afectan a este método: AllowFonts, AllowHeadings, AllowLists, AllowReusableContent, AllowTablesy AllowTextMarkup.
La propiedad AllowImages siempre deben establecerse en True.
Pueden establecer las propiedades AllowHyperlinks y RestrictUrlsToSiteCollection a True o False.
Ejemplos
En este ejemplo se crea un objeto HtmlValidationContext y lo utiliza para restringir y validar un objeto de ImageFieldValue y devuelven una cadena de informe. Functiontakes de muestra en los dos argumentos opcionales:
imageValue: un objeto ImageFieldValue para ejecutarse a través de la validación. Si este argumento está vacía la aplicación utiliza un objeto de ImageFieldValue predeterminado en su lugar.
siteCollectionToRestrict: un SPSite a utilizar para restringir las direcciones URL en HTML. Si este argumento es null las direcciones URL no están restringidas a un SPSite.
// ValidateImageValueSample
using ImageFieldValue = Microsoft.SharePoint.Publishing.Fields.ImageFieldValue;
using LinkFieldValue = Microsoft.SharePoint.Publishing.Fields.LinkFieldValue;
using HtmlValidationContext = Microsoft.SharePoint.Publishing.Fields.HtmlValidationContext;
namespace Microsoft.SDK.SharePointServer.Samples
{
public static string ValidateImageValueSample(
ImageFieldValue imageValue,
SPSite siteCollectionToRestrict)
{
ImageFieldValue imageValueToValidate = imageValue;
// If there is no provided value then construct a new default value
if (null == imageValueToValidate)
{
imageValueToValidate = new ImageFieldValue();
imageValueToValidate.ImageUrl = DefaultImageUrl;
imageValueToValidate.Hyperlink = DefaultHyperlink;
}
string reportString = "Validating the following image value \n[" + imageValueToValidate.ToString() + "]";
HtmlValidationContext validationContext = new HtmlValidationContext();
// Set the constraint properties that apply for image values
validationContext.AllowHyperlinks = true;
if (null == siteCollectionToRestrict)
{
// No site collection provided so do not restrict URLs
validationContext.RestrictUrlsToSiteCollection = false;
validationContext.GuidOfThisSiteCollection = System.Guid.Empty;
}
else
{
// Restrict URLs to be from the provided site collection or to be server relative
validationContext.RestrictUrlsToSiteCollection = true;
validationContext.GuidOfThisSiteCollection = siteCollectionToRestrict.ID;
}
bool droppedTags;
bool droppedUrls;
ImageFieldValue validatedValue =
validationContext.ValidateImageValue(
imageValueToValidate,
out droppedTags,
out droppedUrls);
reportString += "After validation we have the following image value \n[" + validatedValue.ToString() + "]";
return reportString;
}