Sdílet prostřednictvím

Poskytnutí informací o balení a nasazení v položkách projektu

  • Článek

Všechny položky projektu SharePointu v sadě Visual Studio mají vlastnosti, které můžete použít k poskytnutí dalších dat při nasazení projektu do SharePointu. Tyto vlastnosti jsou následující:

  • Vlastnosti funkce

  • Přijímače funkcí

  • Odkazy na výstup projektu

  • položky ovládacího prvku Sejf

    Tyto vlastnosti se zobrazí v okně Vlastnosti .

Vlastnosti funkce

Vlastnost Vlastnosti funkce slouží k určení dat, která tato funkce používá. Data vlastností funkce jsou sada hodnot (uložená jako páry klíč/hodnota), která je součástí funkce při nasazení do SharePointu. Po nasazení funkce budete mít přístup k hodnotám vlastností v kódu.

Když do položky projektu přidáte hodnotu vlastnosti funkce, hodnota se přidá jako prvek v manifestu funkce položky. V projektu modelu obchodních dat Připojení ivity (BDC) se například zobrazí vlastnost funkce ModelFileName takto:

<Property Key="ModelFileName" Value="BdcModel1\BdcModel1.bdcm" />

Jakmile nastavíte hodnotu Feature Property, přidá se jako FeatureProperty element v souboru .spdata projektu. Informace o přístupu k vlastnostem v SharePointu naleznete v tématu SPFeaturePropertyCollection Třída.

Stejné hodnoty vlastností funkce ze všech položek projektu jsou sloučeny společně v manifestu funkce. Pokud však dvě různé položky projektu určují stejný klíč vlastnosti funkce s neodpovídajícími hodnotami, dojde k chybě ověření.

Chcete-li přidat vlastnosti funkce přímo do souboru funkce (.feature), zavolejte metodu Addobjektového modelu sady Visual Studio SharePoint . Pokud používáte tuto metodu, mějte na paměti, že stejné pravidlo o přidání stejných hodnot vlastností funkce ve Vlastnostech funkce platí také pro vlastnosti přidané přímo do souboru funkce.

Přijímač funkcí

Příjemci funkcí jsou kód, který se spustí, když dojde k určitým událostem v položce projektu obsahující funkci. Můžete například definovat přijímače funkcí, které se spouštějí při instalaci, aktivaci nebo upgradu funkce. Jedním ze způsobů, jak přidat příjemce funkce, je přidat ho přímo do funkce, jak je popsáno v návodu: Přidání příjemců událostí funkce. Dalším způsobem je odkazování na název třídy přijímače funkce a sestavení ve vlastnosti Feature Receiver .

Přímá metoda

Když do funkce přidáte příjemce funkce přímo, soubor kódu se umístí do uzlu Funkce v Průzkumník řešení. Když sestavíte řešení SharePointu, kód se zkompiluje do sestavení a nasadí do SharePointu. Ve výchozím nastavení vlastnosti funkce Receiver Assembly a Receiver Třídy odkazují na název třídy a sestavení.

Reference – metoda

Dalším způsobem, jak přidat příjemce funkce, je použití vlastnosti Receiver funkce položky projektu odkazování na sestavení příjemce funkce. Hodnota vlastnosti Feature Receiver má dvě dílčí vlastnosti: sestavení a název třídy. Sestavení musí používat plně kvalifikovaný název "strong" a název třídy musí být úplný název typu. Další informace naleznete v tématu Sestavení se silným názvem. Po nasazení řešení do SharePointu funkce použije odkazovaný příjemce funkce ke zpracování událostí funkcí.

V době sestavení řešení se hodnoty vlastností příjemce funkce ve funkci a jeho projekty sloučí dohromady a nastaví atributy ReceiverAssembly a ReceiverClass prvku Feature v manifestu funkce v souboru řešení SharePoint (Wsp). Proto pokud jsou zadány hodnoty vlastnosti Assembly and Class Name položky projektu a funkce, musí se shodovat hodnoty vlastností položky projektu i vlastnosti funkce. Pokud se hodnoty neshodují, zobrazí se chyba ověření. Pokud chcete, aby položka projektu odkazovala na jiné sestavení příjemce funkce než ta, kterou používá, přesuňte ji do jiné funkce.

Pokud odkazujete na sestavení přijímače funkcí, které ještě není na serveru, je nutné zahrnout také samotný soubor sestavení do balíčku; Visual Studio ho pro vás nepřidá. Při nasazení funkce se soubor sestavení zkopíruje do globální mezipaměti sestavení systému (GAC) nebo do složky Bin ve fyzickém adresáři Služby SharePoint. Další informace naleznete v tématu Postupy: Postupy: Přidání a odebrání dalších sestavení.

Další informace o přijímačích funkcí naleznete v tématu Příjemce událostí funkce a Události funkce.

Odkazy na výstup projektu

Vlastnost Odkazy výstupu projektu určuje závislost, například sestavení, kterou položka projektu potřebuje spustit. Předpokládejme například, že vaše řešení má projekt služby BDC a projekt třídy. Pokud má projekt služby BDC závislost na sestavení, které je výstupem projektu třídy, můžete odkazovat na sestavení ve vlastnosti Project Output References projektu BDC. Při zabalení projektu služby BDC je závislé sestavení součástí balíčku.

Odkazy na výstup projektu jsou obvykle sestavení, ale v některých případech (například projekty Silverlight) mohou být jiné typy souborů.

Další informace naleznete v tématu Postupy: Přidání odkazu na výstup projektu.

položky ovládacích prvků Sejf

SharePoint poskytuje bezpečnostní mechanismus označovaný jako bezpečné kontrolní položky, který omezuje přístup nedůvěryhodných uživatelů na určité ovládací prvky. SharePoint záměrně umožňuje nedůvěryhodným uživatelům nahrávat a vytvářet stránky ASPX na serveru SharePoint. Aby tito uživatelé nemohli přidávat na stránky ASPX nebezpečný kód, sharepointový přístup omezuje na bezpečné ovládací prvky. Sejf ovládací prvky jsou ovládací prvky ASPX a webové části určené jako bezpečné a které můžou používat všichni uživatelé na vašem webu. Další informace najdete v kroku 4: Přidání webové části do seznamu ovládacích prvků Sejf.

Každá položka projektu SharePointu v sadě Visual Studio má vlastnost s názvem položky ovládacího prvku Sejf, která má dvě logické dílčí vlastnosti: Sejf a Sejf Proti skriptu. Vlastnost Sejf určuje, jestli mají nedůvěryhodní uživatelé přístup k ovládacímu prvku. Vlastnost Sejf Proti skriptu určuje, zda mohou nedůvěryhodní uživatelé zobrazit a změnit vlastnosti ovládacího prvku.

Sejf řídicí položky jsou odkazovány na sestavení. Do sestavení projektu přidáte bezpečné položky ovládacího prvku tak, že je zadáte do vlastnosti položky projektu Sejf Položky ovládacího prvku. Při přidání dalšího sestavení do balíčku však můžete do sestavení projektu přidat také bezpečné položky ovládacích prvků prostřednictvím karty Upřesnit v Návrháři balíčků. Další informace naleznete v tématu Postupy: Označení ovládacích prvků jako bezpečných ovládacích prvků nebo registrace sestavení webové části jako Sejf ovládacího prvku.

Položky XML pro bezpečné ovládací prvky

Když do položky projektu nebo do sestavení projektu přidáte bezpečnou položku ovládacího prvku, zapíše se odkaz do manifestu balíčku v následujícím formátu:

<Assemblies>
    <Assembly Location="<assembly name>.dll"
      DeploymentTarget="<'GlobalAssemblyCache' or 'WebApplication'">>
        <SafeControls>
            <SafeControl Assembly="<assembly name>.dll" Namespace=
              "<SharePoint project name>" Safe="<true/false>"
                TypeName="<control name>"
                SafeAgainstScript="<true/false>" />
        </SafeControls>
    </Assembly>
</Assemblies>

Související obsah