Problem
Czasami można spotkać się z sytuacją, gdy należy wprowadzić zmiany do własności konfiguracyjnych WebParta, który jest już wdrożony i skonfigurowany na witrynie. Może to być zmiana typu własności lub jej całkowite usunięcie. Niestety zastosowanie takich zmian najczęściej skończy się błędem podczas następnego podnoszenia WebParta i jedynym rozwiązaniem pozostanie usunięcie wadliwego WebParta i skonfigurowanie go na nowo.
Na szczęście istnieją sposoby radzenia sobie z powyższymi przypadkami.
Przykładowa aplikacja
Załóżmy, że w WebParcie znajdują się dwie problematyczne własności:
- public int[] IntegerArray { get; set; } - nie chcemy dłużej stosować tablicy intów jako własności, ponieważ nie jest ona typu prostego i może powodować problemy (na przykład z SharePoint Designerem). Jednocześnie nie chcemy utracić jej konfiguracji, więc musimy przechwycić stare ustawienia i zapisać je w nowej postaci (na przykład jako string)
- public string OldProperty { get; set; } - jest to stara, już nie wykorzystywana wartość, jednak nie możemy jej po prostu wyrzucić
Zmiany zaczynamy od stworzenia nowej własności, która będzie nową wersją własności IntegerArray. Będzie to własność typu string, a wartości będą przechowywane w niej jako liczby oddzielone przecinkami:
public string StringValues { get; set; }
Jednocześnie musimy obsłużyć wszystkie miejsca w kodzie, gdzie występuje stara własność i modyfikujemy w taki sposób, by obsługiwały nowy format. Jeśli kod kompiluje się prawidłowo, możemy usunąć starą wartość.
Następnie należy zaimplementować interfejs IVersioningPersonalizable, który posiada tylko jedną metodę Load(System.Collections.IDictionary unknownProperties). Jest ona wywoływana po deserializacji WebParta, a jeszcze przed funkcją OnInit(), dlatego jest do dobry moment na obsłużenie zmian.
W zmiennej unknownProperties przechowywane są wszystkie nierozpoznane własności w postaci klucz (string, będący nazwą własności) i wartość (obiekt, który będzie można zrzutować na odpowiedni typ).
W zmiennej unknownProperties przechowywane są wszystkie nierozpoznane własności w postaci klucz (string, będący nazwą własności) i wartość (obiekt, który będzie można zrzutować na odpowiedni typ).
void IVersioningPersonalizable.Load(IDictionary unknownProperties)
{
//iterujemy po wszystkich nierozpoznanych własnościach WebParta
foreach (var key in unknownProperties.Keys)
{
//jeśli jest to zmieniana własność
if (key.ToString().Equals("IntegerArray"))
{
//wiadomo, że nieistniejąca własność jest tablicą liczb całkowitych
int[] oldArray = unknownProperties[key] as int[];
StringBuilder builder = new StringBuilder();
//korzystając ze starych wartości tworzymy nową własność nie tracąc ustawień
foreach (var i in oldArray)
{
if (builder.Length > 0)
builder.Append(",");
builder.Append(i.ToString());
}
//przypisujemy wartość do nowej własności
StringValues = builder.ToString();
_isDirty = true;
}
if (key.ToString().Equals("OldProperty"))
{
//ignorujemy starą nieużywaną wartość
_isDirty = true;
}
}
}
Gdy zostanie wykryta sytuacja, w której należy zaktualizować własności WebParta zmienna _isDirty ustawiana jest na true. Taką sytuację możemy obsłużyć w funkcji OnInit():
if (_isDirty && null != WebPartManager)
{
SetPersonalizationDirty();
_isDirty = false;
}
Wywołując funkcję SetPersonalizationDirty() wymuszamy zapisanie ustawień WebParta.
WEBCON
Błąd składnika Web Part: Nie można wyświetlić lub zaimportować składnika Web Part lub formantu formularza sieci Web na tej stronie. Nie można znaleźć typu lub nie został on zarejestrowany jako bezpieczny.
Pokaż szczegóły błędu
Ukryj szczegóły dotyczące błędu
[UnsafeControlException: Nie można wyświetlić lub zaimportować składnika Web Part lub formantu formularza sieci Web na tej stronie. Nie można znaleźć typu lub nie został on zarejestrowany jako bezpieczny.]
at Microsoft.SharePoint.ApplicationRuntime.SafeControls.GetTypeFromGuid(Guid guid)
at Microsoft.SharePoint.WebPartPages.SPWebPartManager.CreateWebPartsFromRowSetData(Boolean onlyInitializeClosedWebParts) 