Úvod do webového programování v ASP.NET pomocí syntaxe Razor (C#)

tím, že FitzMacken

Tento článek vám poskytne přehled o programování s ASP.NET webovými stránkami pomocí syntaxe Razor. ASP.NET je technologie Microsoftu pro spouštění dynamických webových stránek na webových serverech. Tento článek se C# zaměřuje na používání programovacího jazyka.

Co se naučíte:

• Nejčastějších 8 programovacích tipů pro Začínáme s programováním webových stránek ASP.NET pomocí syntaxe Razor.
• Základní koncepty programování, které budete potřebovat.
• Jaký kód serveru ASP.NET a syntaxe Razor se týkají.

Verze softwaru

• Webové stránky ASP.NET (Razor) 3

Tento kurz funguje také s ASP.NET webovými stránkami 2.

Prvních 8 tipů pro programování

Tato část obsahuje několik tipů, které bezpodmínečně potřebujete znát při psaní kódu ASP.NET serveru pomocí syntaxe Razor.

Další informace o většině těchto programovacích postupů najdete dále v článku.

1. na stránku přidáte kód pomocí znaku @.

Znak @ spouští vložené výrazy, bloky s jedním příkazem a bloky s více příkazy:

<!-- Single statement blocks  -->
@{ var total = 7; }
@{ var myMessage = "Hello World"; }

<!-- Inline expressions -->
<p>The value of your account is: @total </p>
<p>The value of myMessage is: @myMessage</p>

<!-- Multi-statement block -->
@{
    var greeting = "Welcome to our site!";
    var weekDay = DateTime.Now.DayOfWeek;
    var greetingMessage = greeting + " Today is: " + weekDay;
}
<p>The greeting is: @greetingMessage</p>

Tyto příkazy vypadají jako při spuštění stránky v prohlížeči:

2. můžete bloky kódu uzavřít do složených závorek.

Blok kódu obsahuje jeden nebo více příkazů kódu a je uzavřen ve složených závorkách.

<!-- Single statement block.  -->
@{ var theMonth = DateTime.Now.Month; }
<p>The numeric value of the current month: @theMonth</p>

<!-- Multi-statement block. -->
@{
    var outsideTemp = 79;
    var weatherMessage = "Hello, it is " + outsideTemp + " degrees.";
}
<p>Today's weather: @weatherMessage</p>

Výsledek zobrazený v prohlížeči:

3. uvnitř bloku se každý příkaz kódu ukončí středníkem.

Uvnitř bloku kódu musí každý úplný příkaz kódu končit středníkem. Vložené výrazy nekončí středníkem.

<!-- Single-statement block -->
@{ var theMonth = DateTime.Now.Month; }

<!-- Multi-statement block -->
@{
    var outsideTemp = 79;
    var weatherMessage = "Hello, it is " + outsideTemp + " degrees.";
}

<!-- Inline expression, so no semicolon -->
<p>Today's weather: @weatherMessage</p>

4. proměnné použijete k uložení hodnot.

Hodnoty můžete ukládat do proměnné, včetně řetězců, čísel a dat atd. Novou proměnnou vytvoříte pomocí klíčového slova var. Hodnoty proměnných můžete vkládat přímo na stránce pomocí @.

<!-- Storing a string -->
@{ var welcomeMessage = "Welcome, new members!"; }
<p>@welcomeMessage</p>

<!-- Storing a date -->
@{ var year = DateTime.Now.Year; }

<!-- Displaying a variable -->
<p>Welcome to our new members who joined in @year!</p>

Výsledek zobrazený v prohlížeči:

5. Uzavřete řetězcové hodnoty literálu do dvojitých uvozovek.

Řetězec je posloupnost znaků, které jsou považovány za text. Pokud chcete zadat řetězec, uzavřete ho do dvojitých uvozovek:

@{ var myString = "This is a string literal"; }

Pokud řetězec, který chcete zobrazit, obsahuje znak zpětného lomítka (\) nebo dvojité uvozovky ("), použijte doslovné řetězcový literál , který je předponou operátoru @. (V C#, znak \ má zvláštní význam, pokud nepoužijete doslovné řetězcový literál.)

<!-- Embedding a backslash in a string -->
@{ var myFilePath = @"C:\MyFolder\"; }
<p>The path is: @myFilePath</p>

Chcete-li vložit dvojité uvozovky, použijte doslovné řetězcový literál a uvozovky opakujte:

<!-- Embedding double quotation marks in a string -->
@{ var myQuote = @"The person said: ""Hello, today is Monday."""; }
<p>@myQuote</p>

Tady je výsledek použití obou z těchto příkladů na stránce:

6. kód rozlišuje velká a malá písmena.

V C#, klíčová slova (například var, truea if) a názvy proměnných rozlišují malá a velká písmena. Následující řádky kódu vytvoří dvě různé proměnné lastName a LastName.

@{
    var lastName = "Smith";
    var LastName = "Jones";
}

Pokud deklarujete proměnnou jako var lastName = "Smith"; a pokusíte se na ni odkazovat na tuto proměnnou jako @LastName, místo "Smith"se zobrazí hodnota "Jones".

7. mnoho z vašich kódování zahrnuje objekty

Objekt představuje věc, kterou můžete programovat se — stránkou, textovým polem, souborem, obrázkem, webovým požadavkem, e-mailovou zprávou, záznamem zákazníka (řádkem databáze) atd. Objekty mají vlastnosti, které popisují jejich charakteristiky a které můžete číst nebo měnit — objekt textového pole, má vlastnost Text (mimo jiné), objekt požadavku má vlastnost Url, e-mailová zpráva má vlastnost From a objekt Customer má vlastnost FirstName. Objekty mají také metody, které jsou "slovesy" mohou provádět. Mezi příklady patří Save metoda objektu souboru, metoda Rotate objektu obrázku a metoda Send objektu e-mailu.

Často budete pracovat s objektem Request, který vám poskytne informace, jako jsou hodnoty textových polí (pole formuláře) na stránce, jaký typ prohlížeče odeslal požadavek, adresu URL stránky, identitu uživatele atd. Následující příklad ukazuje, jak získat přístup k vlastnostem objektu Request a jak zavolat metodu MapPath objektu Request, který poskytuje absolutní cestu stránky na serveru:

<table border="1">
<tr>
    <td>Requested URL</td>
    <td>Relative Path</td>
    <td>Full Path</td>
    <td>HTTP Request Type</td>
</tr>
<tr>
    <td>@Request.Url</td>
    <td>@Request.FilePath</td>
    <td>@Request.MapPath(Request.FilePath)</td>
    <td>@Request.RequestType</td>
</tr>
</table>

Výsledek zobrazený v prohlížeči:

8. můžete napsat kód, který provede rozhodnutí.

Klíčovou funkcí dynamických webových stránek je, že můžete určit, co dělat na základě podmínek. Nejběžnější způsob, jak to provést, je pomocí příkazu if (a volitelného příkazu else).

@{
   var result = "";
   if(IsPost)
   {
      result = "This page was posted using the Submit button.";
   }
   else
   {
      result = "This was the first request for this page.";
   }
}

<!DOCTYPE html>
<html>
    <head>
        <title></title>
    </head>
<body>
<form method="POST" action="" >
  <input type="Submit" name="Submit" value="Submit"/>
  <p>@result</p>
</form>
</body>
</html>

Příkaz if(IsPost) je zkrácený způsob psaní if(IsPost == true). Spolu s ifmi příkazy existují různé způsoby, jak testovat podmínky, opakovat bloky kódu a tak dále, které jsou popsány dále v tomto článku.

Výsledek zobrazený v prohlížeči (po kliknutí na Odeslat):

Příklad jednoduchého kódu

Tento postup ukazuje, jak vytvořit stránku, která znázorňuje základní programovací techniky. V tomto příkladu vytvoříte stránku, která umožní uživatelům zadat dvě čísla, pak je přidá a zobrazí výsledek.

1. V editoru vytvořte nový soubor a pojmenujte jej AddNumbers. cshtml.

2. Zkopírujte následující kód a označení na stránku a nahraďte cokoli již na stránce.

   @{
       var total = 0;
       var totalMessage = "";
       if(IsPost) {
   
           // Retrieve the numbers that the user entered.
           var num1 = Request["text1"];
           var num2 = Request["text2"];
   
           // Convert the entered strings into integers numbers and add.
           total = num1.AsInt() + num2.AsInt();
           totalMessage = "Total = " + total;
       }
   }
   
   <!DOCTYPE html>
   <html lang="en">
     <head>
       <title>Add Numbers</title>
       <meta charset="utf-8" />
       <style type="text/css">
         body {background-color: beige; font-family: Verdana, Arial;
               margin: 50px; }
         form {padding: 10px; border-style: solid; width: 250px;}
       </style>
     </head>
   <body>
     <p>Enter two whole numbers and then click <strong>Add</strong>.</p>
     <form action="" method="post">
       <p><label for="text1">First Number:</label>
         <input type="text" name="text1" />
       </p>
       <p><label for="text2">Second Number:</label>
         <input type="text" name="text2" />
       </p>
       <p><input type="submit" value="Add" /></p>
     </form>
   
     <p>@totalMessage</p>
   
   </body>
   </html>
   

   Tady je několik věcí, které můžete poznamenat:

   • @ znak spustí první blok kódu na stránce a předá totalMessage proměnnou, která je vložena poblíž dolní části stránky.
   • Blok v horní části stránky je uzavřený ve složených závorkách.
   • V bloku v horní části všechny řádky končí středníkem.
   • Proměnné total, num1, num2a totalMessage ukládají několik čísel a řetězce.
   • Literální řetězcová hodnota přiřazená k proměnné totalMessage je v dvojitých uvozovkách.
   • Vzhledem k tomu, že kód rozlišuje velká a malá písmena, je-li proměnná totalMessage použita v dolní části stránky, její název musí přesně odpovídat proměnné v horní části.
   • Výraz num1.AsInt() + num2.AsInt() ukazuje, jak pracovat s objekty a metodami. Metoda AsInt u každé proměnné převede řetězec zadaný uživatelem na číslo (celé číslo), takže můžete na něm provádět aritmetické operace.
   • Značka <form> obsahuje atribut method="post". To určuje, že když uživatel klikne na Přidat, stránka se pošle na server pomocí metody HTTP POST. Po odeslání stránky se if(IsPost) test vyhodnotí jako true a spustí se podmíněný kód a zobrazí se výsledek přidání čísel.

3. Uložte stránku a spusťte ji v prohlížeči. (Před spuštěním se ujistěte, že je stránka vybraná v pracovním prostoru soubory .) Zadejte dvě celá čísla a potom klikněte na tlačítko Přidat .

   

Základní koncepty programování

Tento článek vám poskytne přehled o ASP.NET webovém programování. Nejedná se o vyčerpávající přezkoumání, a to pouze rychlou prohlídku prostřednictvím konceptů programování, které použijete nejčastěji. I když to bude mít skoro všechno, co budete potřebovat k zahájení práce s ASP.NET webovými stránkami.

Ale první, což je málo technického pozadí.

Syntaxe Razor, kód serveru a ASP.NET

Syntaxe Razor je jednoduchá programovací syntaxe pro vkládání kódu založeného na serveru na webové stránce. Na webové stránce, která používá syntaxe Razor, existují dva druhy obsahu: obsah klienta a kód serveru. Obsah klienta je ta, kterou jste použili pro webové stránky: značky HTML (elementy), informace o stylu, jako je například CSS, možná některý klientský skript, například JavaScript, a prostý text.

Syntaxe Razor umožňuje přidat serverový kód do tohoto obsahu klienta. Pokud je na stránce kód serveru, server nejprve spustí tento kód, než pošle stránku do prohlížeče. Po spuštění na serveru může kód provádět úlohy, které mohou být mnohem složitější pomocí samotného klientského obsahu, jako je například přístup k databázím založeným na serveru. Nejdůležitější je, že serverový kód může dynamicky vytvářet obsah — klienta, který může generovat kód HTML nebo jiný obsah za běhu a pak ho odeslat prohlížeči spolu se všemi statickými HTML, které stránka může obsahovat. V perspektivě prohlížeče se obsah klienta generovaný kódem serveru neliší od jiného obsahu klienta. Jak už jste viděli, kód serveru, který je potřeba, je poměrně jednoduchý.

ASP.NET webové stránky, které zahrnují syntaxe Razor mají speciální příponu souboru ( . cshtml nebo . vbhtml). Server rozpoznává tato rozšíření, spouští kód označený syntaxe Razor a poté odesílá stránku do prohlížeče.

Kde se ASP.NET vejde?

Syntaxe Razor vychází z technologie od Microsoftu s názvem ASP.NET, která je zase založená na .NET Framework Microsoft. The.NET Framework je Big, komplexní programovací rozhraní Microsoftu pro vývoj prakticky jakéhokoli typu počítačové aplikace. ASP.NET je součástí .NET Framework, který je speciálně navržený pro vytváření webových aplikací. Vývojáři používali ASP.NET k vytvoření mnoha největších a nejvyšších webů provozu na světě. (Kdykoli se zobrazí přípona názvu souboru . aspx jako součást adresy URL v lokalitě, budete si vědomi, že se web napsal pomocí ASP.NET.)

Syntaxe Razor poskytuje veškerou sílu ASP.NET, ale s využitím zjednodušené syntaxe, která se snadno naučíte, pokud jste odborníkem na začátečníky a máte vyšší produktivitu. I když se tato syntaxe snadno používá, její rodinný vztah k ASP.NET a .NET Framework znamená, že když se vaše weby stanou sofistikovanější, máte sílu větší architektury, kterou máte k dispozici.

Základní syntaxe

Dříve jste viděli základní příklad, jak vytvořit stránku webových stránek ASP.NET a jak můžete přidat serverový kód do kódu HTML. Tady se naučíte základy psaní kódu serveru ASP.NET pomocí syntaxe Razor — , což jsou pravidla programování.

Pokud máte zkušenosti s programováním (zejména pokud jste použili C, C++, C#, Visual Basic nebo JavaScript), je většina věcí, kterou si přečtete, dobře známá. Pravděpodobně budete potřebovat seznámení pouze s tím, jak je serverový kód přidán do značek v souborech . cshtml .

Kombinování textu, značek a kódu v blocích kódu

V blocích serverového kódu často chcete na stránku výstup textu nebo značky (nebo obojí). Pokud blok kódu serveru obsahuje text, který není kód a místo toho by měl být vykreslen tak, jak je, ASP.NET musí být schopni tento text odlišit od kódu. To lze provést několika způsoby.

• Vložte text do prvku HTML, jako je <p></p> nebo <em></em>:

  @if(IsPost) {
      // This line has all content between matched <p> tags.
      <p>Hello, the time is @DateTime.Now and this page is a postback!</p>
  } else {
      // All content between matched tags, followed by server code.
      <p>Hello <em>stranger</em>, today is: <br /> </p>  @DateTime.Now
  }
  

  Element HTML může obsahovat text, další prvky HTML a výrazy kódu serveru. Když ASP.NET uvidí otevření značky HTML (například <p>), vykreslí vše včetně prvku a jeho obsahu tak, jak je do prohlížeče, a překládá výrazy kódu serveru při jejich přechodu.

• Použijte operátor @: nebo prvek <text>. @: vytvoří výstup jednoho řádku obsahu obsahujícího prostý text nebo nespárované značky HTML. element <text> obklopuje více řádků do výstupu. Tyto možnosti jsou užitečné, pokud nechcete vykreslit prvek HTML jako součást výstupu.

  @if(IsPost) {
      // Plain text followed by an unmatched HTML tag and server code.
      @: The time is: <br /> @DateTime.Now
      <br/>
      // Server code and then plain text, matched tags, and more text.
      @DateTime.Now @:is the <em>current</em> time.
  }
  

  Pokud chcete výstupovat více řádků textu nebo nespárované značky HTML, můžete před každý řádek zadat @:, nebo můžete uzavřít řádek do <text> elementu. Podobně jako operátor @:, jsou<text> značky používány ASP.NET k identifikaci textového obsahu a nejsou nikdy vykresleny ve výstupu stránky.

  @if(IsPost) {
      // Repeat the previous example, but use <text> tags.
      <text>
      The time is: <br /> @DateTime.Now
      <br/>
      @DateTime.Now is the <em>current</em> time.
      </text>
  }
  
  @{
      var minTemp = 75;
      <text>It is the month of @DateTime.Now.ToString("MMMM"), and
      it's a <em>great</em> day! <br /><p>You can go swimming if it's at
      least @minTemp degrees. </p></text>
  }
  

  První příklad opakuje předchozí příklad, ale používá jednu dvojici <text> značek k uzavření textu, který se má vykreslit. V druhém příkladu jsou značky <text> a </text> uzavřeny tři řádky, všechny, které obsahují neuzavřený text a nespárované značky HTML (<br />), spolu s kódem serveru a odpovídajícími značkami HTML. Znovu můžete také předcházet každý řádek jednotlivě pomocí operátoru @:; Jak funguje.

  Note

  Při výstupu textu, jak je znázorněno v — této části pomocí elementu jazyka HTML, operátoru @: nebo elementu — <text> ASP.NET nekóduje výstup do kódu HTML. (Jak bylo uvedeno dříve, ASP.NET zakóduje výstup výrazů serverového kódu a bloků serverového kódu, které jsou před @, s výjimkou zvláštních případů uvedených v této části.)

Typy

Nadbytečné mezery v příkazu (a mimo řetězcový literál) neovlivňují příkaz:

@{ var lastName =    "Smith"; }

Zalomení řádku v příkazu nemá žádný vliv na příkaz a lze zabalit příkazy pro čitelnost. Následující příkazy jsou stejné:

@{ var theName =
"Smith"; }

@{
    var
    personName
    =
    "Smith"
    ;
}

Nemůžete však obtékat čáru uprostřed řetězcového literálu. Následující příklad nefunguje:

@{ var test = "This is a long
    string"; }  // Does not work!

Pro kombinování dlouhého řetězce, který se zalomí na více řádků, jako je výše uvedený kód, existují dvě možnosti. Můžete použít operátor zřetězení (+), který uvidíte dále v tomto článku. Můžete také použít @ znak k vytvoření doslovného řetězcového literálu, jak jste viděli výše v tomto článku. Můžete přerušit doslovné řetězce literálů napříč řádky:

@{ var longString = @"This is a
    long
    string";
}

Komentáře kódu (a označení)

Komentáře umožňují psát si poznámky pro sebe nebo jiné. Také vám umožňují zakázat (komentovat) oddíl kódu nebo značky, které nechcete spustit, ale chcete na stránce uchovávat čas.

Existuje odlišná syntaxe komentářů pro kód Razor a kód HTML. Stejně jako u všech kódů Razor jsou na serveru zpracovávány komentáře Razor (a poté odstraněny) před odesláním stránky do prohlížeče. Proto syntaxe komentářů Razor umožňuje vkládat komentáře do kódu (nebo dokonce do značky), které vidíte při úpravách souboru, ale uživatelé nevidí, i ve zdroji stránky.

V případě komentářů ASP.NET Razor zahájíte komentář pomocí @* a ukončíte ho *@. Komentář může být na jednom řádku nebo několika řádcích:

@*  A one-line code comment. *@

@*
    This is a multiline code comment.
    It can continue for any number of lines.
*@

Zde je komentář v rámci bloku kódu:

@{
    @* This is a comment. *@
    var theVar = 17;
}

Zde je stejný blok kódu, který má řádek s komentářem kódu, aby se nespouštěl:

@{
    @* This is a comment. *@
    @* var theVar = 17;  *@
}

V bloku kódu jako alternativu k použití syntaxe komentářů Razor můžete použít syntaxi komentářů programovacího jazyka, který používáte, například C#:

@{
    // This is a comment.
    var myVar = 17;
    /* This is a multi-line comment
    that uses C# commenting syntax. */
}

V C#jednom řádku předchází // znaků a víceřádkové komentáře začínají /* a končí */. (Stejně jako u komentářů Razor C# nejsou komentáře vykreslovány do prohlížeče.)

V případě značky, jak budete pravděpodobně znát, můžete vytvořit komentář HTML:

<!-- This is a comment.  -->

Komentáře HTML začínají <!--mi znaky a končí -->. K obklopení nejenom textu můžete použít komentáře ve formátu HTML, ale také všechny značky HTML, které můžete chtít na stránce zachovat, ale nechcete je vykreslit. V tomto komentáři HTML se skryje celý obsah značek a text, který obsahují:

<!-- <p>This is my paragraph.</p>  -->

Na rozdíl od komentářů Razor jsou komentáře HTML vykresleny na stránku a uživatel je uvidí pomocí zobrazení zdroje stránky.

Syntaxe Razor má omezení pro vnořené bloky C#. Další informace najdete v pojmenovaných C# proměnných a vnořených blocích generuje porušený kód .

Proměnné

Proměnná je pojmenovaný objekt, který slouží k ukládání dat. Proměnné můžete pojmenovat cokoli, ale název musí začínat znakem abecedy a nesmí obsahovat mezery ani vyhrazené znaky.

Proměnné a datové typy

Proměnná může mít určitý datový typ, který označuje, jaký druh dat je uložený v proměnné. Můžete mít řetězcové proměnné, které ukládají řetězcové hodnoty (například "Hello World"), celočíselné proměnné, které ukládají hodnoty s celými čísly (například 3 nebo 79), a proměnné data uchovávající hodnoty data v různých formátech (například 4/12/2012 nebo březen 2009). A existuje mnoho dalších typů dat, které můžete použít.

Obecně ale nemusíte zadávat typ pro proměnnou. Ve většině času ASP.NET dokáže zjistit typ podle toho, jak se data v proměnné používají. (Někdy musíte zadat typ; uvidíte příklady, kde je to pravda.)

Deklarujete proměnnou pomocí klíčového slova var (Pokud nechcete zadat typ) nebo pomocí názvu typu:

@{
    // Assigning a string to a variable.
    var greeting = "Welcome!";

    // Assigning a number to a variable.
    var theCount = 3;

    // Assigning an expression to a variable.
    var monthlyTotal = theCount + 5;

    // Assigning a date value to a variable.
    var today = DateTime.Today;

    // Assigning the current page's URL to a variable.
    var myPath = this.Request.Url;

    // Declaring variables using explicit data types.
    string name = "Joe";
    int count = 5;
    DateTime tomorrow = DateTime.Now.AddDays(1);
}

Následující příklad ukazuje několik typických použití proměnných na webové stránce:

@{
    // Embedding the value of a variable into HTML markup.
    <p>@greeting, friends!</p>

    // Using variables as part of an inline expression.
    <p>The predicted annual total is: @( monthlyTotal * 12)</p>

    // Displaying the page URL with a variable.
    <p>The URL to this page is: @myPath</p>
}

Pokud na stránce zkombinujete předchozí příklady, zobrazí se v prohlížeči:

Převod a testování datových typů

I když ASP.NET může obvykle určit datový typ automaticky, někdy to nemůže. Proto může být nutné pomáhat s ASP.NETm při provádění explicitního převodu. I v případě, že není nutné převést typy, někdy je vhodné otestovat a zjistit, se kterými typem dat pracujete.

Nejběžnějším případem je, že je nutné převést řetězec na jiný typ, jako je například na celé číslo nebo datum. Následující příklad ukazuje typický případ, kdy je nutné převést řetězec na číslo.

@{
    var total = 0;

    if(IsPost) {
        // Retrieve the numbers that the user entered.
        var num1 = Request["text1"];
        var num2 = Request["text2"];
        // Convert the entered strings into integers numbers and add.
        total = num1.AsInt() + num2.AsInt();
    }
}

Jako pravidlo se vstup uživatele dostane jako řetězce. I když jste si vyzkoušeli, že uživatel zadal číslo, a to i v případě, že zadali číslici, když se odešle vstup uživatele a přečtete ho v kódu, data jsou ve formátu řetězce. Proto je nutné převést řetězec na číslo. Pokud se v příkladu pokusíte provést aritmetické operace s hodnotami bez jejich převádění, dojde k následující chybě, protože ASP.NET nemůže přidat dva řetězce:

Typ String nejde implicitně převést na int.

Chcete-li převést hodnoty na celá čísla, zavolejte metodu AsInt. Pokud je převod úspěšný, můžete čísla přidat.

V následující tabulce jsou uvedeny některé běžné metody převodu a testování pro proměnné.

var myIntNumber = 0;
var myStringNum = "539";
if(myStringNum.IsInt()==true){
    myIntNumber = myStringNum.AsInt();
}

var myStringBool = "True";
var myVar = myStringBool.AsBool();

var myStringFloat = "41.432895";
var myFloatNum = myStringFloat.AsFloat();

var myStringDec = "10317.425";
var myDecNum = myStringDec.AsDecimal();

var myDateString = "12/27/2012";
var newDate = myDateString.AsDateTime();

int num1 = 17;
int num2 = 76;
// myString is set to 1776
string myString = num1.ToString() +
  num2.ToString();

Operátory

Operátor je klíčové slovo nebo znak, který oznamuje ASP.NET, jaký druh příkazu má být proveden ve výrazu. C# Jazyk (a syntaxe Razor, který je na něm založen), podporuje mnoho operátorů, ale stačí, abyste pomohli jenom rozpoznat pár, abyste mohli začít. Následující tabulka shrnuje nejběžnější operátory.

@(5 + 13)
@{ var netWorth = 150000; }
@{ var newTotal = netWorth * 2; }
@(newTotal / 2)

var age = 17;

var myNum = 15;
if (myNum == 15) {
    // Do something.
}

var theNum = 13;
if (theNum != 15) {
    // Do something.
}

if (2 < 3) {
    // Do something.
}
var currentCount = 12;
if(currentCount >= 12) {
    // Do something.
}

// The displayed result is "abcdef".
@("abc" + "def")

int theCount = 0;
theCount += 1; // Adds 1 to count

var myUrl = Request.Url;
var count = Request["Count"].AsInt();

@(3 + 7)
@Request.MapPath(Request.FilePath);

var income = Request["AnnualIncome"];

bool taskCompleted = false;
// Processing.
if(!taskCompleted) {
    // Continue processing
}

bool myTaskCompleted = false;
int totalCount = 0;
// Processing.
if(!myTaskCompleted && totalCount < 12) {
    // Continue processing.
}

Práce s cestami k souborům a složkám v kódu

V kódu často budete pracovat s cestami k souborům a složkám. Tady je příklad fyzické struktury složek pro web, jak se může zobrazit na vašem vývojovém počítači:

C:\WebSites\MyWebSite default.cshtml datafile.txt \images Logo.jpg \styles Styles.css

Tady jsou některé důležité informace o adresách URL a cestách:

• Adresa URL začíná buď s názvem domény (http://www.example.com), nebo s názvem serveru (http://localhost, http://mycomputer).
• Adresa URL odpovídá fyzické cestě na hostitelském počítači. http://myserver například může odpovídat složce C:\websites\mywebsite na serveru.
• Virtuální cesta je zkrácený pro reprezentaci cest v kódu bez nutnosti zadat úplnou cestu. Obsahuje část adresy URL, která následuje za názvem domény nebo serveru. Pokud používáte virtuální cesty, můžete svůj kód přesunout do jiné domény nebo serveru, aniž byste museli cesty aktualizovat.

Tady je příklad, který vám pomůže pochopit rozdíly:

Virtuální kořenový adresář je/, stejně jako kořenový adresář vaší jednotky C:. (Cesty k virtuálním složkám vždycky používají lomítka.) Virtuální cesta ke složce nemusí mít stejný název jako fyzická složka; může to být alias. (Na provozních serverech se virtuální cesta zřídka shoduje s přesnou fyzickou cestou.)

Když pracujete se soubory a složkami v kódu, někdy potřebujete odkazovat na fyzickou cestu a někdy na virtuální cestu v závislosti na objektech, se kterými pracujete. ASP.NET poskytuje tyto nástroje pro práci s cestami k souborům a složkám v kódu: metoda Server.MapPath a operátor ~ a metoda Href.

Převod virtuálních na fyzické cesty: Metoda Server. MapPath

Metoda Server.MapPath Převede virtuální cestu (například /Default.cshtml) na absolutní fyzickou cestu (například C:\WebSites\MyWebSiteFolder\default.cshtml). Tuto metodu použijete kdykoli, když potřebujete úplnou fyzickou cestu. Typickým příkladem je, že načítáte nebo píšete textový soubor nebo soubor obrázku na webovém serveru.

Obvykle neznáte absolutní fyzickou cestu k webu na serveru hostujícího webu, takže tato metoda může převést cestu, kterou znáte – virtuální cestu – k odpovídající cestě na serveru za vás. Do metody předáte virtuální cestu k souboru nebo složce a vrátíte fyzickou cestu:

@{
    var dataFilePath = "~/dataFile.txt";
}
<!-- Displays a physical path C:\Websites\MyWebSite\datafile.txt  -->
<p>@Server.MapPath(dataFilePath)</p>

Odkazování na virtuální kořenový adresář: operátor ~ a metoda href

V souboru . cshtml nebo . vbhtml můžete odkazovat na virtuální kořenovou cestu pomocí operátoru ~. To je velmi užitečné, protože můžete přesouvat stránky v lokalitě a jakékoli odkazy, které obsahují na jiné stránky, nebudou přerušeny. K dispozici je také užitečné v případě, že jste web někdy přesunuli do jiného umístění. Zde je několik příkladů:

@{
    var myImagesFolder = "~/images";
    var myStyleSheet = "~/styles/StyleSheet.css";
}

Pokud je web http://myserver/myapp, v takovém případě bude ASP.NET považovat tyto cesty při spuštění stránky:

• myImagesFolder: http://myserver/myapp/images
• myStyleSheet: http://myserver/myapp/styles/Stylesheet.css

(Tyto cesty ve skutečnosti neuvidíte jako hodnoty proměnné, ale ASP.NET je bude považovat za to, co byly.)

Operátor ~ lze použít jak v kódu serveru (jak je uvedeno výše), tak v označení, například takto:

<!-- Examples of using the ~ operator in markup in ASP.NET Web Pages -->

<a href="~/Default">Home</a>
<img src="~/images/MyImages.png" />

V kódu se používá operátor ~ k vytváření cest k prostředkům, jako jsou soubory obrázků, jiné webové stránky a soubory CSS. Po spuštění stránky ASP.NET vyhledá stránku (kód i kód) a přeloží všechny ~ odkazy na příslušnou cestu.

Podmíněná logika a smyčky

Kód serveru ASP.NET vám umožňuje provádět úlohy na základě podmínek a napsat kód, který opakuje příkazy, a to podle určitého počtu, kolikrát (tj. kód spouštějící smyčku).

Podmínky testování

Chcete-li otestovat jednoduchou podmínku, použijte příkaz if, který vrací hodnotu true nebo false na základě testu, který zadáte:

@{
  var showToday = true;
  if(showToday)
  {
    @DateTime.Today;
  }
}

Klíčové slovo if spustí blok. Skutečný test (podmínka) je v závorkách a vrátí hodnotu true nebo false. Příkazy, které se spustí, pokud je test true, jsou uzavřeny ve složených závorkách. Příkaz if může zahrnovat blok else, který určuje příkazy, které se mají spustit, pokud je podmínka nepravdivá:

@{
  var showToday = false;
  if(showToday)
  {
    @DateTime.Today;
  }
  else
  {
    <text>Sorry!</text>
  }
}

Pomocí else ifového bloku můžete přidat víc podmínek:

@{
    var theBalance = 4.99;
    if(theBalance == 0)
    {
        <p>You have a zero balance.</p>
    }
    else if (theBalance  > 0 && theBalance <= 5)
    {
        <p>Your balance of $@theBalance is very low.</p>
    }
    else
    {
        <p>Your balance is: $@theBalance</p>
    }
}

V tomto příkladu, pokud není první podmínka v bloku If nastavena na hodnotu true, je zaškrtnuta podmínka else if. Pokud je tato podmínka splněna, jsou provedeny příkazy v bloku else if. Pokud není splněna žádná z podmínek, jsou provedeny příkazy v bloku else. Můžete přidat libovolný počet else if Blocks a pak zavřít s else blok jako "vše jiného" podmínka.

K otestování velkého počtu podmínek použijte switch blok:

@{
    var weekday = "Wednesday";
    var greeting = "";

    switch(weekday)
    {
        case "Monday":
            greeting = "Ok, it's a marvelous Monday";
            break;
        case "Tuesday":
            greeting = "It's a tremendous Tuesday";
            break;
        case "Wednesday":
            greeting = "Wild Wednesday is here!";
            break;
        default:
            greeting = "It's some other day, oh well.";
            break;
    }

    <p>Since it is @weekday, the message for today is: @greeting</p>
}

Hodnota, která se má testovat, je v závorkách (v příkladu weekday proměnné). Každý jednotlivý test používá příkaz case, který končí dvojtečkou (:). Je-li hodnota příkazu case shodná s testovací hodnotou, je proveden kód v tomto bloku případu. Všechny příkazy Case zavřete příkazem break. (Pokud zapomenete zahrnout do každého bloku case, kód z dalšího příkazu case se spustí také.) switch blok často obsahuje default příkaz jako poslední případ pro "vše ostatní" možnost, která se spustí, pokud žádný z ostatních případů neplatí.

Výsledek posledního dvou podmíněných bloků zobrazených v prohlížeči:

Kód smyčky

Často je třeba spouštět stejné příkazy opakovaně. Provedete to pomocí smyčky. Například často spustíte stejné příkazy pro každou položku v kolekci dat. Pokud víte přesně, kolikrát chcete cyklovat, můžete použít smyčku for. Tento druh smyčky je zvláště užitečný pro inventarizaci a počítání:

@for(var i = 10; i < 21; i++)
{
    <p>Line #: @i</p>
}

Smyčka začíná klíčovým slovem for, po kterém následují tři příkazy v závorkách, přičemž každý z nich končí středníkem.

• V závorkách první příkaz (var i=10;) vytvoří čítač a inicializuje jej na hodnotu 10. Nemusíte pojmenovat i — čítače. můžete použít libovolnou proměnnou. Po spuštění smyčky for se čítač automaticky zvýší.
• Druhý příkaz (i < 21;) nastaví podmínku pro jak daleko chcete počítat. V takovém případě chcete, aby bylo možné přejít maximálně o 20 (to znamená, že bude pokračovat i v případě, že je čítač menší než 21).
• Třetí příkaz (i++) používá operátor přírůstek, který jednoduše určuje, že čítač by měl mít 1 přidaný čítač při každém spuštění smyčky.

Uvnitř složených závorek je kód, který se spustí pro každou iteraci smyčky. Kód vytvoří nový odstavec (<p> element) pokaždé a přidá řádek do výstupu a zobrazí hodnotu i (čítač). Když spustíte tuto stránku, v příkladu se vytvoří 11 řádků, ve kterých se zobrazí výstup, a text na každém řádku, který označuje číslo položky.

Pokud pracujete s kolekcí nebo polem, často používáte smyčku foreach. Kolekce je skupina podobných objektů a smyčka foreach umožňuje provádět úlohy na každé položce v kolekci. Tento typ smyčky je vhodný pro kolekce, protože na rozdíl od for smyčky nemusíte zvyšovat čítač nebo nastavit limit. Místo toho kód smyčky foreach jednoduše projde přes kolekci, dokud není dokončena.

Například následující kód vrátí položky v kolekci Request.ServerVariables, což je objekt, který obsahuje informace o vašem webovém serveru. Používá smyčku foreac h k zobrazení názvu každé položky vytvořením nového prvku <li> v seznamu s odrážkami HTML.

<ul>
@foreach (var myItem in Request.ServerVariables)
{
    <li>@myItem</li>
}
</ul>

Za klíčovým slovem foreach následuje závorky, kde deklarujete proměnnou reprezentující jednu položku v kolekci (v příkladu var item) následovaný klíčovým slovem in následovaným kolekcí, kterou chcete procyklovat. V těle foreach smyčky můžete k aktuální položce přistupovat pomocí proměnné, kterou jste předtím deklarovali.

Chcete-li vytvořit obecnější smyčku pro účely, použijte příkaz while:

@{
    var countNum = 0;
    while (countNum < 50)
    {
        countNum += 1;
        <p>Line #@countNum: </p>
    }
}

Smyčka while začíná klíčovým slovem while následovanými závorkami, kde určíte, jak dlouho bude smyčka pokračovat (zde, pokud je countNum menší než 50), pak se blok opakuje. Smyčky typicky přidávají (přidávají do) nebo snižují (odečtou z) proměnnou nebo objekt, který se používá pro počítání. V příkladu operátor += přidá 1 pro countNum pokaždé, když se smyčka spustí. (Chcete-li snížit proměnnou ve smyčce, která počítá dolů, použijte operátor snížení -=).

Objekty a kolekce

Skoro všechno na webu ASP.NET je objekt, včetně samotné webové stránky. Tato část popisuje některé důležité objekty, se kterými se často pracujete ve vašem kódu.

Objekty stránky

Nejzákladnější objekt v ASP.NET je stránka. K vlastnostem objektu stránky můžete přistupovat přímo bez jakéhokoli opravňujícího objektu. Následující kód Získá cestu k souboru stránky pomocí objektu Request stránky:

@{
    var path = Request.FilePath;
}

Chcete-li zrušit zaškrtnutí, že odkazujete na vlastnosti a metody v objektu aktuální stránky, můžete volitelně použít klíčové slovo this pro reprezentaci objektu Page v kódu. Zde je předchozí příklad kódu s this přidat k reprezentaci stránky:

@{
    var path = this.Request.FilePath;
}

Pomocí vlastností objektu Page můžete získat velké množství informací, například:

• Request. Jak už jste viděli, jedná se o kolekci informací o aktuální žádosti, včetně typu prohlížeče, který požadavek odeslal, adresu URL stránky, identitu uživatele atd.

• Response. Toto je kolekce informací o odpovědi (stránky), která se odešle do prohlížeče, když je kód serveru spuštěný. Tuto vlastnost můžete například použít k zápisu informací do odpovědi.

  @{
      // Access the page's Request object to retrieve the Url.
      var pageUrl = this.Request.Url;
  }
  <a href="@pageUrl">My page</a>
  

Objekty kolekce (pole a slovníky)

Kolekce je skupina objektů stejného typu, například kolekce Customer objektů z databáze. ASP.NET obsahuje mnoho předdefinovaných kolekcí, jako je kolekce Request.Files.

Často budete pracovat s daty v kolekcích. Dva společné typy kolekcí jsou pole a slovník. Pole je užitečné, pokud chcete uložit kolekci podobných položek, ale nechcete vytvořit samostatnou proměnnou pro uchování každé položky:

@* Array block 1: Declaring a new array using braces. *@
@{
    <h3>Team Members</h3>
    string[] teamMembers = {"Matt", "Joanne", "Robert", "Nancy"};
    foreach (var person in teamMembers)
    {
        <p>@person</p>
    }
}

Pomocí polí deklarujete konkrétní datový typ, například string, intnebo DateTime. Chcete-li označit, že proměnná může obsahovat pole, přidejte do deklarace hranaté závorky (například string[] nebo int[]). K položkám v poli můžete přistupovat pomocí jejich pozice (indexu) nebo pomocí příkazu foreach. Indexy polí jsou počítány od — nuly, tj. první položka je na pozici 0, druhá položka je na pozici 1 atd.

@{
    string[] teamMembers = {"Matt", "Joanne", "Robert", "Nancy"};
    <p>The number of names in the teamMembers array: @teamMembers.Length </p>
    <p>Robert is now in position: @Array.IndexOf(teamMembers, "Robert")</p>
    <p>The array item at position 2 (zero-based) is @teamMembers[2]</p>
    <h3>Current order of team members in the list</h3>
    foreach (var name in teamMembers)
    {
        <p>@name</p>
    }
    <h3>Reversed order of team members in the list</h3>
    Array.Reverse(teamMembers);
    foreach (var reversedItem in teamMembers)
    {
        <p>@reversedItem</p>
    }
}

Počet položek v poli můžete určit získáním jeho vlastnosti Length. Chcete-li získat pozici konkrétní položky v poli (pro hledání v poli), použijte metodu Array.IndexOf. Můžete také provést akce, jako je vrácení obsahu pole (Array.Reverse metody) nebo řazení obsahu (metoda Array.Sort).

Výstup kódu řetězcového pole zobrazeného v prohlížeči:

Slovník je kolekce párů klíč/hodnota, kde zadáte klíč (nebo název) pro nastavení nebo načtení příslušné hodnoty:

@{
    var myScores = new Dictionary<string, int>();
    myScores.Add("test1", 71);
    myScores.Add("test2", 82);
    myScores.Add("test3", 100);
    myScores.Add("test4", 59);
}
<p>My score on test 3 is: @myScores["test3"]%</p>
@{myScores["test4"] = 79;}
<p>My corrected score on test 4 is: @myScores["test4"]%</p>

Chcete-li vytvořit slovník, použijte klíčové slovo new pro indikaci, že vytváříte nový objekt Dictionary. K proměnné můžete přiřadit slovník pomocí klíčového slova var. Datové typy položek ve slovníku označíte pomocí lomených závorek (< >). Na konci deklarace je nutné přidat dvojici závorek, protože se jedná o metodu, která vytvoří nový slovník.

Chcete-li přidat položky do slovníku, můžete zavolat metodu Add proměnné Dictionary (myScores v tomto případě) a poté zadat klíč a hodnotu. Alternativně můžete pomocí hranatých závorek označit klíč a provést jednoduché přiřazení, jako v následujícím příkladu:

myScores["test4"] = 79;

Pokud chcete získat hodnotu ze slovníku, zadáte klíč v závorkách:

var testScoreThree = myScores["test3"];

Volání metod s parametry

Jak si přečtete výše v tomto článku, objekty, se kterými program pracuje, můžou mít metody. Například Database objekt může mít metodu Database.Connect. Mnoho metod má také jeden nebo více parametrů. Parametr je hodnota, kterou předáte metodě, aby mohla metoda dokončit její úlohu. Podívejte se například na deklaraci metody Request.MapPath, která přijímá tři parametry:

public string MapPath(string virtualPath, string baseVirtualDir, 
    bool allowCrossAppMapping);

(Řádek byl zabalen, aby byl čitelnější. Mějte na paměti, že můžete umístit konce řádků téměř na jakékoli místo kromě řetězců, které jsou uzavřeny v uvozovkách.)

Tato metoda vrátí fyzickou cestu na serveru, který odpovídá zadané virtuální cestě. Tři parametry pro metodu jsou virtualPath, baseVirtualDira allowCrossAppMapping. (Všimněte si, že v deklaraci jsou parametry uvedeny s datovými typy dat, která budou přijímat.) Při volání této metody je nutné dodat hodnoty pro všechny tři parametry.

Syntaxe Razor poskytuje dvě možnosti pro předávání parametrů metodě: poziční parametry a pojmenované parametry. Chcete-li volat metodu pomocí pozičních parametrů, předáte parametry v přesném pořadí, které je zadáno v deklaraci metody. (Toto pořadí byste obvykle znali v dokumentaci k metodě.) Je nutné postupovat podle pořadí a v případě potřeby nemůžete přeskočit — žádný z parametrů, předáte prázdný řetězec ("") nebo null pozičního parametru, pro který nemáte hodnotu.

Následující příklad předpokládá, že máte ve svém webu složku s názvem skripty . Kód volá metodu Request.MapPath a předá hodnoty pro tři parametry ve správném pořadí. Pak zobrazí výslednou mapovanou cestu.

@{
    // Pass parameters to a method using positional parameters.
    var myPathPositional = Request.MapPath("/scripts", "/", true);
}
<p>@myPathPositional</p>

Pokud má metoda mnoho parametrů, můžete si kód lépe přečíst pomocí pojmenovaných parametrů. Chcete-li volat metodu pomocí pojmenovaných parametrů, zadejte název parametru následovaný dvojtečkou (:) a pak hodnotu. Výhodou pojmenovaných parametrů je, že je můžete předat v libovolném požadovaném pořadí. (Nevýhodou je, že volání metody není jako kompaktní.)

Následující příklad volá stejnou metodu jako výše, ale používá pojmenované parametry k poskytnutí těchto hodnot:

@{
    // Pass parameters to a method using named parameters.
    var myPathNamed = Request.MapPath(baseVirtualDir: "/", 
        allowCrossAppMapping: true, virtualPath: "/scripts");
}
<p>@myPathNamed</p>

Jak vidíte, parametry jsou předány v jiném pořadí. Pokud však spustíte předchozí příklad a tento příklad vrátí stejnou hodnotu.

Zpracování chyb

Příkazy try-catch

Často budete mít ve svém kódu příkazy, které mohou selhat z důvodů mimo váš ovládací prvek. Příklad:

• Pokud se váš kód pokusí vytvořit soubor nebo k němu získat přístup, může dojít k nejrůznějším chybám. Soubor, který chcete, možná neexistuje, může být uzamčen, kód pravděpodobně nemá oprávnění atd.
• Podobně platí, že pokud se váš kód pokusí aktualizovat záznamy v databázi, může dojít k problémům s oprávněními, připojení k databázi může být vyřazeno, data, která mají být uložena, mohou být neplatná atd.

V programovacích podmínkách se tyto situace nazývají výjimky. Pokud váš kód narazí na výjimku, vygeneruje (vyvolá) chybovou zprávu, která je na nejvyšší úrovni uživatelům obtěžující:

V situacích, kdy se váš kód může setkat s výjimkami, a aby se předešlo chybovým zprávám tohoto typu, můžete použít příkazy try/catch. V příkazu try spustíte kód, který kontrolujete. V jednom nebo více příkazech catch můžete vyhledat konkrétní chyby (konkrétní typy výjimek), ke kterým mohlo dojít. Můžete zahrnout tolik příkazů catch, kolik potřebujete pro hledání chyb, které očekáváte.

Následující příklad ukazuje stránku, která vytvoří textový soubor pro první požadavek a pak zobrazí tlačítko, které uživateli otevře soubor. Příklad záměrně používá špatný název souboru, takže bude způsobovat výjimku. Kód zahrnuje catch příkazy pro dvě možné výjimky: FileNotFoundException, ke kterým dojde, pokud je název souboru špatný a DirectoryNotFoundException, ke kterému dochází, pokud ASP.NET nemůže dokonce najít složku. (Můžete zrušit komentář k příkazu v příkladu, abyste viděli, jak se spustí, když vše funguje správně.)

Pokud váš kód nezpracovává výjimku, zobrazila se chybová stránka, například snímek předchozí obrazovky. Nicméně část try/catch pomáhá zabránit uživateli v zobrazování těchto typů chyb.

@{
    var dataFilePath = "~/dataFile.txt";
    var fileContents = "";
    var physicalPath = Server.MapPath(dataFilePath);
    var userMessage = "Hello world, the time is " + DateTime.Now;
    var userErrMsg = "";
    var errMsg = "";

    if(IsPost)
    {
        // When the user clicks the "Open File" button and posts
        // the page, try to open the created file for reading.
        try {
            // This code fails because of faulty path to the file.
            fileContents = File.ReadAllText(@"c:\batafile.txt");

            // This code works. To eliminate error on page,
            // comment the above line of code and uncomment this one.
            //fileContents = File.ReadAllText(physicalPath);
        }
        catch (FileNotFoundException ex) {
            // You can use the exception object for debugging, logging, etc.
            errMsg = ex.Message;
            // Create a friendly error message for users.
            userErrMsg = "A file could not be opened, please contact "
                + "your system administrator.";
        }
        catch (DirectoryNotFoundException ex) {
            // Similar to previous exception.
            errMsg = ex.Message;
            userErrMsg = "A directory was not found, please contact "
                + "your system administrator.";
        }
    }
    else
    {
        // The first time the page is requested, create the text file.
        File.WriteAllText(physicalPath, userMessage);
    }
}

<!DOCTYPE html>
<html lang="en">
    <head>
        <meta charset="utf-8" />
        <title>Try-Catch Statements</title>
    </head>
    <body>
    <form method="POST" action="" >
      <input type="Submit" name="Submit" value="Open File"/>
    </form>

    <p>@fileContents</p>
    <p>@userErrMsg</p>

    </body>
</html>

Další prostředky

Programování pomocí Visual Basic

Příloha: Visual Basic jazyk a syntax

Referenční dokumentace

ASP.NET

C#Language