Implémentation de l’interface IRenderingExtension

L’extension de rendu prend les résultats d’une définition de rapport combinée aux données réelles et affiche les données résultantes dans un format utilisable. La transformation des données combinées IRenderingExtensionet de la mise en forme est effectuée à l’aide d’une classe CLR (Common Language Runtime) qui implémente . Cela transforme le modèle objet en un format de sortie consommable par une visionneuse, une imprimante ou une autre cible de sortie.

Les IRenderingExtension trois méthodes doivent être codées :

• Render - affiche le rapport.

• RenderStream - affiche un flux spécifique à partir du rapport.

• GetRenderingResource - obtient des informations supplémentaires, telles que des icônes, requises pour le rapport.

Les sections suivantes décrivent ces méthodes plus en détail.

Render, méthode

La Render méthode contient des arguments qui représentent les objets suivants :

• Rapport à afficher. Cet objet contient des propriétés, des données et des informations de disposition pour le rapport. Le rapport est la racine de l’arborescence du modèle objet de rapport.

• ServerParameters qui contiennent l’objet dictionnaire de chaînes, avec les paramètres du serveur de rapports, le cas échéant.

• Paramètre deviceInfo qui contient les paramètres de l’appareil. Pour plus d’informations, consultez Passage des paramètres d’informations sur l’appareil aux extensions de rendu.

• Paramètre clientCapabilities qui contient un NameValueCollection objet de dictionnaire qui contient des informations sur le client sur lequel vous effectuez le rendu.

• RenderProperties qui contient des informations sur le résultat de rendu.

• CreateAndRegisterStream est une fonction déléguée à appeler pour obtenir un flux à afficher.

paramètre deviceInfo

Le paramètre deviceInfo contient des paramètres de rendu, et non des paramètres de rapport. Ces paramètres de rendu sont passés à l’extension de rendu. Les valeurs deviceInfo sont converties en objet NameValueCollection par le serveur de rapports. Les éléments du paramètre deviceInfo sont traités comme des valeurs qui ne respectent pas la casse. Si la demande de rendu est venue à la suite de l’accès à l’URL, les paramètres d’URL du formulaire rc:key=value sont convertis en paires clé/valeur dans l’objet de dictionnaire deviceInfo . Le code de détection du navigateur fournit également les éléments suivants dans le dictionnaire clientCapabilities : EcmaScriptVersion, JavaScript, MajorVersion, MinorVersion, Win32, Type et AcceptLanguage. Toute paire nom/valeur dans le paramètre deviceInfo qui n’est pas comprise par l’extension de rendu est ignorée. L’exemple de code suivant montre un exemple GetRenderingResource de méthode qui récupère les icônes :

public void GetRenderingResource (CreateStream createStreamCallback, NameValueCollection deviceInfo)  
{  
    string[] iconTagValues = deviceInfo.GetValues("Icon");  
    if ((iconTagValues != null) && (iconTagValues.Length > 0) )  
    {  
        // Create a stream to output to.  
        Stream outputStream = createStreamCallback(m_iconResourceName, "gif", null, "image/gif", false);  
        // Get the GIF image for one of the buttons on the toolbar  
        Image requiredImage = (Image) m_resourcemanager.GetObject(m_iconResourceName  
        // Write the image to the output stream  
        requiredImage.Save(outputStream, requiredImage.RawFormat);  
    }  
    return;  
}  

RenderStream, méthode

La RenderStream méthode affiche un flux particulier à partir du rapport. Tous les flux sont créés pendant l’appel initial Render , mais les flux ne sont pas retournés au client initialement. Cette méthode est utilisée pour les flux secondaires, tels que les images dans le rendu HTML ou des pages supplémentaires d’une extension de rendu à plusieurs pages, comme Image/EMF.

GetRenderingResource, méthode

La GetRenderingResource méthode récupère les informations sans exécuter un rendu complet du rapport. Il existe des moments où le rapport requiert des informations qui ne nécessitent pas le rendu du rapport lui-même. Par exemple, si vous avez besoin de l’icône associée à l’extension de rendu, utilisez le paramètre deviceInfo contenant l’icône> de balise< unique. Dans ces cas, vous pouvez utiliser la GetRenderingResource méthode.

Voir aussi

Implémentation d’une extension de rendu
Vue d’ensemble des extensions de rendu