Plik Readme programu WebMatrix 1.0

13 stycznia 2011 r.

Zawartość

Uwaga

Ten plik readme dotyczy wersji 1.0 programu WebMatrix.

Omówienie

Microsoft WebMatrix 1.0 to bezpłatny stos tworzenia aplikacji internetowych instalowany w ciągu kilku minut. Integruje serwer internetowy z bazą danych i strukturami programowania, aby utworzyć jedno zintegrowane środowisko. Możesz użyć programu WebMatrix, aby usprawnić sposób tworzenia kodu, testowania i publikowania własnej witryny internetowej ASP.NET lub PHP. Możesz też użyć programu WebMatrix, aby uruchomić nową witrynę internetową przy użyciu popularnych aplikacji typu open source, takich jak DotNetNuke, Umbraco, WordPress lub Php. Program WebMatrix korzysta z tego samego zaawansowanego serwera internetowego, aparatu bazy danych i środowiska platform, które będzie uruchamiać witrynę internetową w Internecie, co sprawia, że przejście od programowania do środowiska produkcyjnego jest bezproblemowe i bezproblemowe.

Instalacja

Aby zainstalować program WebMatrix 1.0, należy najpierw zainstalować Instalator platformy Microsoft Web 3.0. Po zainstalowaniu Instalatora platformy sieci Web można go użyć do zainstalowania programu WebMatrix.

Jeśli masz problemy podczas instalacji, zapoznaj się z tematem Rozwiązywanie problemów z Instalator platformy Microsoft Web.

Jak publikować aplikacje

Zobacz Instrukcje krok po kroku dotyczące publikowania aplikacji

Zmiany i problemy

Problemy z instalacją programu WebMatrix 1.0

Problem: Program WebMatrix 1.0 jest dostępny tylko na platformach obsługujących usługę Microsoft .NET Framework 4

Program WebMatrix wymaga .NET Framework w wersji 4. W niektórych przypadkach instalator programu WebMatrix 1.0 umożliwia próbę zainstalowania na platformie, która nie jest częścią obsługiwanego zestawu konfiguracji. W szczególności system Windows Vista bez aktualizacji z dodatkiem SP1 umożliwi rozpoczęcie instalacji programu WebMatrix, ale składnik .NET Framework 4 zakończy się niepowodzeniem i zablokuje instalację.

Obejście
Zainstaluj na obsługiwanej platformie, która obejmuje:

  • Windows 7
  • Windows Server 2008
  • Windows Server 2008 z dodatkiem R2
  • Windows Vista z dodatkiem SP1 lub nowszym
  • Windows XP z dodatkiem SP3
  • Windows Server 2003 SP2

Problem: Nie można zainstalować programu WebMatrix 1.0, jeśli program Microsoft Visual Studio 2008 jest zainstalowany bez programu Microsoft Visual Studio 2008 SP1

Obejście
Zainstaluj program Microsoft Visual Studio 2008 z dodatkiem Service Pack 1 z Centrum pobierania Microsoft.

Problem: Niektóre zestawy dla SQL Server Compact 4.0 nie są zainstalowane w pamięci GAC

Zarządzane zestawy dla SQL Server Compact 4.0 nie są umieszczane w globalnej pamięci podręcznej zestawów (GAC) podczas instalowania SQL Server Compact 4.0 na komputerze 64-bitowym, a komputer ma zainstalowany tylko profil klienta .NET Framework 3.5 SP1. Zarządzane zestawy, które nie są zainstalowane w pamięci GAC, to:

  • System.Data.SqlServerCe.dll (dostawca ADO.NET)
  • System.Data.SqlServerCe.Entity.dll (ADO.NET Entity Framework)

Obejście
Odinstaluj SQL Server Compact 4.0. Pobierz i zainstaluj pełną wersję programu .NET Framework 3.5 SP1 z następującej lokalizacji:

Microsoft .NET Framework 3.5 z dodatkiem Service Pack 1 (pełny pakiet)

Następnie zainstaluj ponownie SQL Server Compact 4.0.

Problem: Nie można odinstalować SQL Server Compact przy użyciu wiersza polecenia

Odinstalowanie SQL Server Compact przy użyciu opcji wiersza polecenia nie działa w tej wersji.

Obejście
Użyj programów i funkcji w Panel sterowania systemu Windows, aby odinstalować Microsoft SQL Server Compact 4.0.

ASP.NET Web Pages

W tej sekcji dokumentu opisano nowe funkcje, zmiany i znane problemy z wersją 1.0 ASP.NET Stron internetowych ze składnią Razor.

Nowe funkcje

Nowe: dodano ustawienie konfiguracji w celu wyłączenia menedżera pakietów

Nowy asp:AdminManagerEnabled klucz jest dostępny dla <appSettings> elementu w pliku web.config , co pozwala całkowicie wyłączyć menedżera pakietów. Wartość domyślna dla tego elementu ma wartość true, co oznacza, że jeśli nie znajduje się w pliku web.config , menedżer pakietów jest włączony. Aby wyłączyć menedżera pakietów, dodaj następujący element do pliku web.config w katalogu głównym witryny internetowej:

<configuration>
  <appSettings>
    <add key="asp:AdminManagerEnabled" value="false"/>
  </appSettings>
</configuration>

Zmiany

Zmień nazwę klucza "webPages:AdminFolderVirtualPath" na "asp:AdminFolderVirtualPath"

Klucz webPages:AdminFolderVirtualPath , który można dodać do pliku web.config w celu określenia lokalizacji menedżera pakietów, został zmieniony tak, aby używał asp: przestrzeni nazw zamiast webPages przestrzeni nazw. Jeśli używasz tego elementu, musisz zmienić jego nazwę w pliku konfiguracji.

Znane problemy

Problem: Hasła użytkowników członkostwa nie są już rozpoznawane

Algorytm tworzenia i przechowywania haseł członkostwa (logowania) został zmieniony, aby był bardziej bezpieczny. W związku z tym hasła przechowywane dla członków (użytkowników) utworzonych w wersjach beta ASP.NET Razor nie zostaną rozpoznane.

Obejście Jeśli lokacja nie została jeszcze umieszczona w środowisku produkcyjnym, usuń rekordy użytkowników z bazy danych członkostwa. Jeśli baza danych jest aktywna, programowo wygeneruj istniejące hasła w bazie danych członkostwa.

Problem: Nieoczekiwane zachowanie podczas używania niestandardowej tabeli użytkowników do członkostwa

Aby zainicjować dostawcę członkostwa dla witryny internetowej Razor ASP.NET, należy wywołać metodę WebSecurity.InitializeDatabaseConnection . (W programie WebMatrix szablon witryny początkowej zawiera wywołanie tej metody w pliku _AppStart.cshtml ). autoCreateTables Jeśli parametr tej metody jest ustawiony na true (domyślnie jest ustawiony na wartość true w szablonie witryny początkowej), a jeśli nierozpoznana nazwa tabeli jest przekazywana do metody (drugi parametr), metoda nie zgłasza błędu. Zamiast tego automatycznie tworzy tabelę.

Może to być problem, jeśli zamierzasz użyć niestandardowej tabeli użytkowników do członkostwa, ale przekaż nieprawidłową nazwę tabeli do WebSecurity.InitializeDatabaseConnection metody . Ponieważ metoda nie zgłasza domyślnie błędu, jeśli określona tabela nie istnieje, a ponieważ zamiast tego tworzy nową tabelę, aplikacja może wydawać się działać. Jednak kod aplikacji, który opiera się na niestandardowej tabeli użytkownika (i na polach w nim), może ostatecznie zakończyć się niepowodzeniem z nieoczekiwanymi błędami.

Obejście
Upewnij się, że nazwa przekazana w InitializeDatabaseConnection metodzie jest zgodna z tabelą profilu użytkownika w bazie danych członkostwa lub upewnij się, że autoCreateTables parametr ma wartość false.

Problem: Komunikat o błędzie "Moduł Administracja wymaga dostępu do ~/App_Data"

W niektórych okolicznościach próba utworzenia użytkowników lub w inny sposób praca z systemem członkostwa ASP.NET może spowodować wyświetlenie błędu Moduł Administracja wymaga dostępu do ~/App_Data. Dzieje się tak, jeśli konto, w ramach którego działają usługi IIS lub IIS Express, nie ma uprawnień do tworzenia i zapisywania w folderze App_Data w katalogu głównym witryny sieci Web.

Obejście Ręcznie utwórz folder App_Data dla witryny sieci Web. Następnie upewnij się, że konto systemu Windows, w ramach którego działa aplikacja (zazwyczaj USŁUGA SIECIOWA) ma uprawnienia do odczytu/zapisu dla folderów głównych aplikacji i dla podfolderów, takich jak App_Data. Bardziej szczegółowe informacje są dostępne w temacie Problemy z SQL Server Express uzyskiwaniem dostępu użytkownika i ASP.net projektami aplikacji internetowych.

Problem: Błąd "Nie można wygenerować wystąpienia użytkownika SQL Server"

Jeśli aplikacja internetowa WebMatrix używa SQL Server Express i korzysta z usług IIS 7.5 w systemie Windows 7 lub Windows Server 2008 R2, może zostać wyświetlony błąd wskazujący, że SQL Server nie może pobrać lokalnej ścieżki aplikacji użytkownika w czasie wykonywania.

Obejście Upewnij się, że konto systemu Windows, w ramach którego działa aplikacja (zazwyczaj USŁUGA SIECIOWA) ma uprawnienia do odczytu/zapisu dla folderów głównych aplikacji i podfolderów, takich jak App_Data. Bardziej szczegółowe informacje są dostępne w temacie Problemy z SQL Server Express uzyskiwaniem dostępu użytkownika i ASP.net projektami aplikacji internetowych.

Problem: Pliki zawierające zasoby menedżera pakietów lub hasła menedżera pakietów są dostępne w usługach IIS 6.0 i starszych

Jeśli wdrożysz aplikację ASP.NET Web Pages (Razor), która została skompilowana przy użyciu wersji RC2, a jeśli aplikacja zawiera plikpassword.txt lub packagesources.txt w obszarze /App_Data/admin, usługi IIS 6.0 będą obsługiwać plik w razie żądania, potencjalnie ujawniając hasła dla wystąpienia menedżera pakietów.

Obejście Zmień nazwę pliku password.txt lub packagesources.txt na password.config lub packagesources.config. Domyślnie usługi IIS 6.0 nie obsługują plików z rozszerzeniem .config . (W usługach IIS 7 nie są obsługiwane żadne pliki w folderze App_Data , więc nie trzeba zmieniać nazw plików).

Problem: Odinstalowanie pakietów zainstalowanych przy użyciu wersji Beta 3 nie powoduje całkowitego usunięcia składników pakietu

Jeśli pakiet został zainstalowany przy użyciu menedżera pakietów w wersji Beta 3, a następnie spróbuj odinstalować go przy użyciu bieżącej wersji, pakiet nie zostanie całkowicie odinstalowany. Użycie przycisku Odinstaluj menedżera pakietów powoduje usunięcie niektórych składników, ale pozostawia kod biblioteki pakietu i nie aktualizuje pliku package.config .

Obejście
Wykonaj następujące kroki:

  1. Usuń folder App_Data\packages . Spowoduje to usunięcie wszystkich pakietów.
  2. Usuń plik packages.config w katalogu głównym witryny internetowej.

Problem: W programie Visual Studio wywoływanie internetowego menedżera pakietów przełącza aplikację w tryb offline

Jeśli pracujesz w programie Visual Studio (a nie w programie WebMatrix) i używasz funkcji _admin do uruchamiania menedżera pakietów, program Visual Studio przełącza aplikację w tryb offline i publikuje app_offline.htm w katalogu głównym witryny internetowej, co zakłóca możliwość korzystania z menedżera pakietów.

Uwaga

Chociaż w przypadku korzystania z internetowego interfejsu menedżera pakietów najczęściej jest widoczne to zachowanie, to samo zachowanie występuje w przypadku dodawania, usuwania lub modyfikowania plików w folderze App_Data .

Obejście
Aby pracować z pakietami w programie Visual Studio, użyj rozszerzenia NuGet zamiast internetowego menedżera pakietów. Aby uzyskać więcej informacji, zobacz dokumentację narzędzia NuGet. Jeśli pracujesz z innymi plikami w folderze App_Data , rozważ przechowywanie plików w innym miejscu, aby uniknąć tego problemu. Jeśli nie jest to praktyczne, usuń plik app_offline.htm ręcznie lub zaczekaj na automatyczne powrót witryny do trybu online (domyślnie po 30 sekundach).

Problem: Funkcja IntelliSense programu Visual Studio i szablony projektów dostępne tylko w ASP.NET MVC w wersji 3

Instalowanie ASP.NET stron sieci Web nie powoduje również zainstalowania narzędzi dla programu Visual Studio, takich jak IntelliSense i szablony projektów dla aplikacji ASP.NET Web Pages.

Obejście Aby używać funkcji IntelliSense i szablonów projektów dla aplikacji ASP.NET Web Pages w programie Visual Studio, zainstaluj ASP.NET MVC 3 RC za pośrednictwem Instalatora platformy internetowej lub autonomicznego instalatora.

Problem: Odczytywanie źródeł danych lub innych danych zewnętrznych za pośrednictwem serwera proxy

Jeśli serwer z uruchomioną lokacją znajduje się za serwerem proxy, może być konieczne skonfigurowanie informacji o serwerze proxy w pliku web.config w celu umożliwienia odczytu informacji spoza witryny. Jeśli na przykład używasz ReCaptcha pomocnika, pomocnik komunikuje się z usługą reCAPTCHA, ale może zostać zablokowany przez serwer proxy. Podobnie źródła danych, które są używane w ASP.NET Stron sieci Web, takie jak źródło danych używane przez menedżera pakietów, mogą wymagać konfiguracji serwera proxy.

Jeśli występują problemy z pracą z usługą zewnętrzną lub pracą ze źródłem danych pakietów, umieść następujące elementy w głównym pliku web.config aplikacji:

<system.net>
  <defaultProxy>
    <proxy autoDetect="False" 
       proxyaddress="[proxy URL]"/>
  </defaultProxy>
</system.net>

Aby uzyskać więcej informacji na temat konfigurowania serwera proxy, zobacz <element proxy> (ustawienia sieci) w witrynie sieci Web MSDN.

Problem: Odinstalowanie .NET Framework w wersji 4 powoduje wyłączenie ASP.NET stron internetowych przy użyciu składni Razor

Jeśli odinstalujesz .NET Framework w wersji 4, a następnie ponownie zainstalujesz ją, ASP.NET strony sieci Web ze składnią Razor zostaną wyłączone. Strony z rozszerzeniem cshtml nie działają poprawnie. ASP.NET strony sieci Web rejestrują zestaw w pliku web.configgłównym komputera i usuwa .NET Framework usuwa ten plik. Ponowne zainstalowanie .NET Framework powoduje zainstalowanie nowej wersji pliku konfiguracji, ale nie powoduje dodania odwołania do zestawu ASP.NET Web Pages.

Obejście Po ponownym zainstalowaniu .NET Framework zainstaluj ponownie ASP.NET stron internetowych za pomocą składni Razor. Spowoduje to dodanie następującego elementu do pliku web.config w katalogu głównym maszyny, który zazwyczaj znajduje się w następującej lokalizacji:

C:\Windows\Microsoft.NET\Framework\v4.0.30319\Config (32-bit)
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Config (64-bit)

<compilation>
  <assemblies>
    <add assembly="System.Web.WebPages.Configuration, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" />

    <-- Additional assemblies here. -->

  </assemblies>
</compilation>

Problem: Bez rozszerzenia adresy URL nie znajdują plików cshtml/.vbhtml w usługach IIS 7 lub IIS 7.5

W usługach IIS 7 lub IIS 7.5 żądania o adresie URL, takim jak poniżej, nie mogą znaleźć stron, które mają rozszerzenie cshtml lub vbhtml :

http://www.example.com/ExampleSite/ExampleFile

Problem występuje, ponieważ ponowne zapisywanie adresów URL nie jest domyślnie włączone dla usług IIS 7 lub IIS 7.5. Najbardziej podobny scenariusz polega na tym, że nie widzisz problemu podczas testowania lokalnego przy użyciu IIS Express, ale występuje podczas wdrażania witryny internetowej hostingu.

Obejście

Problem: Wdrażanie aplikacji na komputerze, na którym nie zainstalowano SQL Server Compact

Aplikacje, które obejmują SQL Server Compact bazy danych, mogą być uruchamiane na komputerze, na którym nie zainstalowano SQL Server Compact. Program Microsoft WebMatrix 1.0 automatycznie kopiuje te pliki binarne i wykonuje odpowiednie przekształcenia plikówweb.config .

Obejście Jeśli musisz skopiować te pliki i ręcznie wprowadzić zmiany w plikuweb.config , wykonaj następujące czynności:

  1. Skopiuj zestawy aparatu bazy danych do folderu Bin (i podfolderów) aplikacji na komputerze docelowym:

    • Kopiowanie C:\Program Files\Microsoft SQL Server Edition\v4.0\Desktop\System.Data.SqlServerCe.dll
      do\Bin
    • Kopiowanie C:\Program Files\Microsoft SQL Server Compact Edition\v4.0\Private\x86\to\Bin\x86
    • Kopiuj C:\Program Files\Microsoft SQL Server Compact Edition\v4.0\Private\amd64\* to\Bin\amd64
  2. W folderze głównym witryny internetowej utwórz lub otwórz plik web.config . (W programie WebMatrix 1.0 ten typ pliku jest dostępny po kliknięciu pozycji Wszystkie w oknie dialogowym Wybieranie typu pliku ).

  3. Dodaj następujący element jako element podrzędny <configuration> elementu (nie wewnątrz <system.web> elementu):

    <system.data>
      <DbProviderFactories>
        <remove invariant="System.Data.SqlServerCe.4.0"></remove>
        <add name="Microsoft SQL Server Compact Data Provider" 
          invariant="System.Data.SqlServerCe.4.0" 
          Description=".NET Framework Data Provider for Microsoft SQL Server Compact" 
          type="System.Data.SqlServerCe.SqlCeProviderFactory, System.Data.SqlServerCe, Version=4.0.0.0, Culture=neutral, PublicKeyToken=89845dcd8080cc91"/>
      </DbProviderFactories>
    </system.data>
    

Problem: Pomocnicy "Database" i "WebGrid" nie działają w warstwie Średnia relacja zaufania w Visual Basic

Jeśli używasz języka Visual Basic (tworzenie plików vbhtml ), Database pomocnicy i WebGrid nie będą działać, jeśli aplikacja ma używać średniego zaufania.

Obejście
Jeśli używasz programu Visual Studio 2010, możesz rozwiązać ten problem, instalując wersję dodatku Service Pack 1. Do momentu udostępnienia ostatecznej wersji dodatku SP1 można pobrać wersję beta dodatku SP1 ze strony dodatku Microsoft Visual Studio 2010 z dodatkiem Service Pack 1 w Centrum pobierania Microsoft.

Jeśli nie jest to praktyczne lub nie używasz programu Visual Studio 2010, możesz tymczasowo ustawić aplikację tak, aby korzystała z funkcji Full Trust.

Problem: zasoby "ApplicationPart" są dostępne zewnętrznie

Jeśli zestaw zawiera obiekty pochodzące z ApplicationPart klasy, zasoby tego zestawu są udostępniane przez klasę ResourceRouteHandler . Rozważmy na przykład następujący adres URL:

~/r.ashx/System.Web.WebPages.Administration/Resources/AdminResources.resources

To żądanie pobiera wszystkie ciągi zasobów w zestawie System.Web.WebPages.Administration.dll . Pobierane są wszystkie zasoby osadzone (nawet te, które nie są przeznaczone do obsługi jako zawartość statyczna). Jeśli osadzone zasoby zawierają poufne informacje, może to stanowić zagrożenie bezpieczeństwa.

Obejście
Jeśli tworzysz obiekt ApplicationPart , upewnij się, że osadzone zasoby skojarzone z zestawem obiektu ApplicationPart nie zawierają informacji poufnych.

WebMatrix

Uwaga

Aby uzyskać informacje o problemach z instalacją programu WebMatrix, zobacz WebMatrix Installation Issues (Problemy z instalacją programu WebMatrix ) we wcześniejszej sekcji tego dokumentu.

W tej sekcji dokumentu opisano znane problemy dotyczące środowiska programistycznego WebMatrix.

Problem: Zmiany nazwy użytkownika lub hasła bazy danych parametry połączenia w pliku web.config nie są odzwierciedlane w obszarze roboczym Bazy danych

Obejście

  1. W pliku web.config zmień nazwę bazy danych w parametry połączenia (na przykład dodaj do niej wartość "1").
  2. Zapisz plik web.config .
  3. Kliknij pozycję Bazy danych i odśwież.
  4. Zmień nazwę bazy danych w parametry połączenia w pliku web.config z powrotem na oryginalną nazwę bazy danych.
  5. Zapisz plik web.config .
  6. Kliknij pozycję Bazy danych i odśwież.

Problem: Nie można usunąć folderów utworzonych przez program WebMatrix

Jeśli program WebMatrix jest uruchomiony przy użyciu podniesionych uprawnień (czyli uruchomiono program WebMatrix przy użyciu opcji Uruchom jako administrator w systemie Windows), folderów utworzonych przez program WebMatrix nie można usunąć przy użyciu Eksploratora Windows.

Obejście
Uruchom Eksploratora Windows przy użyciu podwyższonych uprawnień. Wykonaj następujące kroki:

  1. W systemie Windows kliknij przycisk Start.
  2. Wprowadź ciąg "Eksplorator Windows" i kliknij prawym przyciskiem myszy wpis dla Eksploratora Windows.
  3. Kliknij pozycję Uruchom jako administrator. Następnie można usunąć foldery.

Problem: Program WebMatrix 1.0 nie może wykonać pewnych zadań wymagających podniesienia uprawnień

Program WebMatrix 1.0 nie może wykonywać pewnych zadań wymagających podniesienia uprawnień, takich jak instalowanie dodatkowych składników w następujących sytuacjach:

  • W systemie Windows Vista lub Windows 7 użytkownik jest zalogowany przy użyciu konta, które nie ma uprawnień administracyjnych, a kontrola konta użytkownika (UAC) jest wyłączona.
  • Używasz systemu Microsoft Windows XP lub Microsoft Windows Server 2003.

Obejście
Większość zadań w programie WebMatrix 1.0 nie wymaga uprawnień administracyjnych. W przypadku tych, które to robią, możesz wykonać operację jako administrator lub wykonać następujące kroki:

  • W systemie Windows Vista lub Windows 7 włącz funkcję kontrola konta użytkownika.
  • W systemie Windows XP dodaj użytkownika do grupy zabezpieczeń Administratorzy.

Opcja Witryna z galerii sieci Web jest wyłączona, jeśli instalator platformy sieci Web 3.0 nie jest zainstalowany.

Obejście
Zainstaluj Instalator platformy Microsoft Web 3.0.

Problem: Google Chrome nie jest dostępna jako opcja Uruchom

Przeglądarka Google Chrome nie jest wyświetlana na liście przeglądarek w obszarze Uruchom na karcie Narzędzia główne.

Obejście
Niektóre wersje przeglądarki Google Chrome nie rejestrują się poprawnie za pomocą funkcji Programy domyślne w systemie Windows. Aby obejść ten problem, uruchom przeglądarkę Google Chrome, kliknij menu Dostosuj i steruj przeglądarką Google Chrome , kliknij pozycję Opcje, a następnie kliknij pozycję Ustaw przeglądarkę Google Chrome jako domyślną.

Problem: Okno dialogowe "Klucz obcy" nie zezwala na wprowadzanie klucza podstawowego

Okno dialogowe Klucz obcy nie umożliwia wprowadzenia nazwy klucza podstawowego z tabeli kluczy podstawowych.

Obejście
Jest to działanie celowe. Nie trzeba wprowadzać nazwy klucza podstawowego z tabeli kluczy podstawowych.

Problem: Funkcja IntelliSense nie jest dostępna w programie WebMatrix dla składni Razor, C# lub Visual Basic

Funkcja IntelliSense jest obsługiwana w programie WebMatrix dla języków HTML i CSS. Nie jest jednak dostępna dla innych języków.

Obejście
Brak.

Problem: Funkcja IntelliSense dla języków HTML i CSS sugeruje elementy, które nie są odpowiednie kontekstowo

Funkcja IntelliSense dla znaczników w programie WebMatrix obsługuje kod HTML przy użyciu schematu przejściowego XHTML 1.0 i css przy użyciu schematu CSS 2.1. Ponieważ funkcja IntelliSense jest oparta na tych konkretnych schematach, niektóre tagi, atrybuty lub właściwości mogą być sugerowane, że nie są odpowiednie dla bieżącej definicji strony lub stylu. W przypadku kodu HTML może również prowadzić do nieoczekiwanych sugestii w zawartości, które mogą być interpretowane jako źle sformułowany kod XHTML (na przykład wtedy, gdy tagi nie są zamykane). Ten problem może być bardziej zauważalny, jeśli punkt wstawiania znajduje się wewnątrz niekompletnego tagu; w takim przypadku funkcja IntelliSense może sugerować nowe tagi otwierania lub oferować inne nieprawidłowe sugestie.

Obejście
W przypadku języka HTML upewnij się, że pracujesz w dobrze sformułowanej, pełnej stronie XHTML. W przypadku arkuszy CSS nie ma obejścia.

Problem: Funkcja IntelliSense nie jest wywoływana podczas wpisywania

Czasami funkcja IntelliSense może nie być wywoływana, ponieważ kod HTML lub CSS jest wprowadzany w edytorze. W szczególności może się to zdarzyć, gdy punkt wstawiania znajduje się bezpośrednio obok innego elementu lub na końcu pliku.

Obejście
Upewnij się, że wokół punktu wstawiania znajduje się biały znak i że punkt wstawiania nie znajduje się na końcu pliku. Funkcję IntelliSense można również wywołać ręcznie, naciskając klawisze Ctrl+Spacja.

Problem: Brak interfejsu użytkownika jest dostępny do wyłączania funkcji IntelliSense

Program WebMatrix 1.0 nie zapewnia interfejsu użytkownika ani gestu wyłączania funkcji IntelliSense.

Obejście
Uruchom program WebMatrix przy użyciu następującego polecenia, które zawiera przełącznik wyłączający funkcję IntelliSense:

WebMatrix.exe #ExecuteCommand# EditorIntelliSense off

IIS Express

IIS Express ma własny plik readme, który jest dostępny pod następującym adresem URL:

https://go.microsoft.com/fwlink/?LinkID=207675& clcid=0x409

SQL Server Compact

SQL Server Compact ma własny plik readme, który jest dostępny pod następującym adresem URL:

https://go.microsoft.com/fwlink/?LinkID=208545

Aby uzyskać informacje o problemach związanych z instalowaniem SQL Server Compact w ramach programu WebMatrix, zobacz Problemy z instalacją programu WebMatrix we wcześniejszej części tego dokumentu.

Instalowanie aplikacji

Problem: Instalowanie aplikacji może zająć dużo czasu, jeśli folder Moje dokumenty użytkownika jest przekierowywany do udziału sieciowego

Obejście
Brak. Instalacja aplikacji może zająć trochę czasu, ale zostanie zainstalowana poprawnie.

Publikowanie aplikacji

Problem: Błąd "Nie można uzyskać wymaganych uprawnień" podczas publikowania bazy danych SQL Compact Database

Program WebMatrix nie obsługuje w pełni wdrażania pomocniczych plików binarnych dla SQL Server Compact na serwerze z systemem .NET Framework w wersji 3.5 z konfiguracją średniego zaufania.

Obejście
Preferowanym obejściem jest zainstalowanie .NET Framework 4 na serwerze. Alternatywnie wykonaj następujące czynności:

  1. Dodaj następujące elementy do SecurityClasses sekcji w pliku Web_MediumTrust.config :

    <SecurityClass Name="ReflectionPermission" 
      Description="System.Security.Permissions.ReflectionPermission, mscorlib, 
        Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>	
        
    <SecurityClass Name="RegistryPermission" 
      Description="System.Security.Permissions.RegistryPermission, mscorlib, 
      Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
    
  2. Utwórz nowy zestaw uprawnień w pliku Web_MediumTrust.configz następującymi wymaganymi uprawnieniami:

    <PermissionSet class="NamedPermission" version="1" Name="SqlCe_Trust">
      <IPermission class="SecurityPermission" version="1" Flags="UnmanagedCode,SkipVerification"/>
      <IPermission class="EnvironmentPermission" version="1" Read="PROCESSOR_ARCHITECTURE"/>
      <IPermission class="RegistryPermission" version="1" Read="HKEY_LOCAL_MACHINE\" />
    </PermissionSet>
    
  3. Zastosuj zestaw uprawnień do SQL Server Compact, umieszczając następujące elementy w pliku Web_MediumTrust.config:

    <CodeGroup class="UnionCodeGroup" version="1" PermissionSetName="ASP.Net">
      <IMembershipCondition class="UrlMembershipCondition" version="1" Url="$AppDirUrl$/*"/> 
      <CodeGroup class="UnionCodeGroup" 
          version="1" 
          PermissionSetName="SqlCe_Trust" 
          Name="SqlCe_Strong_Name" 
          Description="This code group grants code signed with the SQLCE strong name SqlCe_Trust. ">
        <IMembershipCondition class="StrongNameMembershipCondition" 
          version="1" 
          PublicKeyBlob="0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8" Name="System.Data.SqlServerCe" />
      </CodeGroup> 
    </CodeGroup>
    

W niektórych okolicznościach publikowanie aplikacji powoduje błąd "usługa jest niedostępna".

Obejście
W programie WebMatrix dodaj ukośnik odwrotny () na końcu nazwy serwera w oknie Ustawienia publikowania , a następnie ponownie opublikuj aplikację.

Po opublikowaniu aplikacji Moodle aplikacja nie działa poprawnie.

Obejście
W programie WebMatrix dodaj ukośnik (/) na końcu pola Nazwa witryny w oknie Ustawienia publikowania , a następnie ponownie opublikuj aplikację.

Problem: Publikowanie nopCommerce kończy się niepowodzeniem z powodu błędu bazy danych

Publikowanie nopCommerce kończy się niepowodzeniem i zgłasza błąd bazy danych, taki jak "Wstawianie do tabeli nop_log nie powiodło się".

Obejście

  1. W programie WebMatrix kliknij pozycję Uruchom , aby uruchomić aplikację nopCommerce lokalnie.
  2. Zaloguj się do strony administracyjnej.
  3. Kliknij menu System .
  4. Kliknij opcję Dziennik .
  5. Kliknij przycisk Wyczyść dziennik .
  6. Opublikuj ponownie nopCommerce.

Problem: Program CmS Silverstripe wyświetla komunikat o błędzie HTTP 500 PHP FCGI podczas pobierania opublikowanej witryny

Obejście
Po kliknięciu pozycji Pobierz opublikowaną witrynę pomiń silverstripe-cache/manifest_main publikowanie w wersji zapoznawczej. Ten plik jest używany do celów buforowania i jest specyficzny dla każdego komputera.

Problem: Podtekst wyświetla komunikat "Błąd serwera w aplikacji "/" podczas pobierania opublikowanej witryny

Obejście
Otwórz plik web.config witryny i zastąp identyfikator użytkownika i hasło w bazie danych parametry połączenia poświadczeniami administratora SQL Server (poświadczenia "sa").

Możesz też wykonać następujące kroki, aby nadać konto użytkownika, do którego zalogowano się przy użyciu db_owner uprawnień:

  1. Zainstaluj SQL Server Management Studio przy użyciu Instalatora platformy sieci Web.
  2. Połącz się z lokalnym wystąpieniem SQL Server Express (domyślnie .\SQLEXPRESS).
  3. Kliknij pozycję Bazy danych>[localSubtextDatabase]>Użytkownicy>zabezpieczeń>[localSubtextUser] (wartość domyślna to subtextuser], kliknij prawym przyciskiem myszy i kliknij polecenie Właściwości.
  4. Wybierz db_owner w sekcji członkostwa w rolach.

Problem: Witryna może nie działać po opublikowaniu, jeśli pole "Docelowy adres URL" nie jest poprzedzone http:// lub https://

W oknie dialogowym Ustawienia publikowania , jeśli docelowy adres URL nie zaczyna się od http:// lub https://, witryna może nie działać po wdrożeniu.

Obejście
Upewnij się, że przed opublikowaniem witryny docelowy adres URL w oknie dialogowym Ustawienia publikowania rozpoczyna się od http:// lub https://.

Problem: Publikowanie bazy danych MySQL kończy się niepowodzeniem z powodu błędu "Nie można opublikować bazy danych. Może się tak zdarzyć, jeśli zdalna baza danych nie może uruchomić skryptu.

Ten błąd może wystąpić z wielu powodów. Przyczyną tego błędu jest to, że jeśli skrypt bazy danych zawiera pojedynczy znak cudzysłowu ('), a domyślny zestaw znaków docelowej bazy danych MySQL nie ma wartości UTF-8.

Obejście
Ustaw domyślny zestaw znaków dla zdalnej bazy danych MySQL na UTF-8.

W przypadku publikowania lub pobierania witryny DotNetNuke może być konieczne wyczyszczenie pamięci podręcznej w celu uzyskania nowych linków do wyświetlenia w witrynie.

Obejście

  1. Zaloguj się jako "Host".
  2. Przejdź do menu hosta i wybierz pozycję Ustawienia hosta.
  3. Przewiń w dół i w obszarze Ustawienia zaawansowane rozwiń pozycję Ustawienia wydajności.
  4. Kliknij link Clear Cache (Wyczyść pamięć podręczną ) dla stron.
  5. Przejdź do dołu strony i uruchom ponownie aplikację.

Obejście
W pliku service.config plikusers.config i wszystkie pliki .xml zastąp ciąg adresu URL (na przykład ) lokalną (na przykład http://myhost.com/atomsitehttp://localhost:1239).

Problem: Aplikacje oparte na bazie danych MySQL, takie jak WordPress, nie mogą publikować i zgłaszać błędu bazy danych

Domyślnie program WebMatrix instaluje program MySQL z zestawem znaków UTF-8. Jeśli zainstalujesz program MySQL samodzielnie, a zestaw znaków nie jest utF-8 (na przykład jest to latin1), proces publikowania baz danych może zakończyć się niepowodzeniem.

Obejście

  1. Zmień zestaw znaków dla programu MySQL na UTF-8. (Aby uzyskać szczegółowe informacje, zobacz Zestaw znaków serwera i sortowanie w witrynie internetowej MySQL).
  2. Zainstaluj ponownie aplikację.
  3. Opublikuj ponownie aplikację.

Problem: "Pobieranie opublikowanej witryny" kończy się niepowodzeniem dla aplikacji, które mają konfigurację opartą na przeglądarce

Niektóre aplikacje (na przykład Kentico CMS) wymagają uruchomienia ich w przeglądarce w celu wykonania konfiguracji po instalacji, takiej jak tworzenie bazy danych. Jeśli opublikujesz taką aplikację bez ukończenia konfiguracji opartej na przeglądarce, próba pobrania tej samej lokacji z serwera zdalnego zakończy się niepowodzeniem.

Obejście
Zakończ konfigurację opartą na przeglądarce przed opublikowaniem witryny.

Problem: "Pobieranie opublikowanej witryny" kończy się niepowodzeniem z powodu błędu bazy danych dotNetNuke i kooboo CMS

Jeśli spróbujesz pobrać aplikację z serwera i masz poświadczenia administratora w bazie danych parametry połączenia w oknie dialogowym Ustawienia publikowania, może zostać wyświetlony następujący błąd w dzienniku publikowania:

1:28:29 PM: An error occurred during execution of the database script. The approximate location of the error was between lines '3260' and '3262' of the script. The verbose log may have more information about the error. The command started with:

1:28:29 PM: CREATE LOGIN [MACHINE\Administrator] FROM WINDOW

1:28:29 PM: https://go.microsoft.com/fwlink/?LinkId=178587.

Obejście
Jeśli jest to praktyczne, opublikuj ponownie witrynę (lub opublikuj ją) przy użyciu poświadczeń innych niż administrator dla bazy danych.

Aby uzyskać więcej informacji

Aby uzyskać więcej informacji na temat programu WebMatrix 1.0, zobacz następujące witryny internetowe: